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This publication describes the input/output supervisor, which 
consists of the control program routines that carry on input/output 
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routines start, monitor, and, where necessary, restart activity on 
input/output devices. EoUowing an introduction, there is a Method 
of Operation section in this publication which is organized to reflect 
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VaUdating Input Data 
ScheduUng I/O Operations 
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The remaining sections of this publication support the Method of 
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directories for PLM-to-listing and listing-to-PLM transitions, 
descriptions of data areas, diagnostic aids, and appendixes. 
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design. Program logic information is not necessary for the use and 
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PREFACE 



This publication, when used in conjunction with program Ustings, will enable you to 
understand enough about the input/output (I/O) supervisor to be able to make 
changes to it 

The publication relies heavily on operation diagrams that show how the I/O supervisor 
Qf^erates and identif"^ the routines that perform the operations. The operation diagrams 
are keyed to other parts of the publications. For further information, you can refer to 
flowcharts or, via a directory of symbolic names, to the program listing. 

This manual is not designed to replace the program listings; it supplements tliern and 
makes the information they contain more easily accessible. It is divided into seven- 
sections, each describing certain aspects of the program: 

"Section 1: Introduction," relates the I/O supervisor to users of its services and to the 
operating system, and describes overall I/O supervisor operation. 

"Section 2: Method of Operation," contains diagrams that describe how the I/O 
supervisor functions, with emphasis on the data it uses, where it obtains the data, and 
how it acts upon that data to initiate and control I/O activity. 

"Section 3: Program Organization," contains a functional organization chart and 
flowcharts of individual I/O supervisor routines. 

"Section 4: Directories," contains information to be used for PLM-to-listing and 
hsting-to-PLM transitions. Included are a module directory and a data area directory. 

"Section 5: Data Areas," contains descriptions of the interrelationship and content of 
principal data areas used by the I/O supervisor. 

"Section 6: Diagnostic Aids," contains information of a general nature which could be 
helpful in interpreting program listings. 

"Section 7: Appendixes," is intended to supplement both this publication and the 
listings. Included are descriptions of SVC routines not covered in other sections, 
descriptions of some of the more involved optional features, descriptions of messages 
produced by I/O supervisor routines, a list of abbreviations, and a glossary. 

Before using this publication, read the Introduction to establish perspective, and then at 
least scan the remainder to familiarize yourself with its content. This publication is 
primarily a reference manual because each section contains a specific type of 
information. You will be better able to service the program when you can refer quickly 
to the section containing the type of information you need. 

You are assumed to have a knowledge of programming for OS and should at least have 
reviewed recently the section on I/O programming in the publications IBM 
System/ 3 60 Principles of Operation, GA22-6821, and /5M System/ 370 
Principles of Operation, GA22-7000. Continual reference to the above publications 
is encouraged in order that readers fully understand the significance of some aspects of 
I/O supervisor logic. 



ui 



This publication can serve Multiprogramming with a Fixed Number of Tasks (MFT) 
users and Multiprogramming with a Variable Number of Tasks (MVT) users. First 
read the introductory PLMs for your respective systems: 

OS MFT Supervisor Logic, GY27-7236 

OS MVT Supervisor Logic, GY28-6651 

There are publications available that contain information about individual I/O devices. 
These are listed in the publication IBM System/ 360 and System/ 3 70 Bibliography, 
GA22-6822. 
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SECTION 1: INTRODUCTION 



Following execution of the statements or instructions written by programmers to cause 
I/O activity, a sequence of events begins in which the I/O supervisor plays a major 
role. This section defines that role and describes the environment in which it is 
performed. 
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Introduction 



An input/output operation can be described as the sequence of events beginning with 
execution of the statement or instruction a programmer writes to cause data to be 
written on or read from an input/output device and ending when all related activity is 
completed. Although the input/output supervisor plays a major role in the 
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that is involved. The purpose of this section is to establish the scope and objectives of 
the input/output supervisor. 

First, the I/O supervisor as it relates to the user of its services is decribed. The user 
can be a programmer who writes using a higher-level language, or who writes using an 
assembler language with access method macro instructions. The user may also be a 
control program routine that is writing data into a system data set. All users of the 
I/O supervisor must provide it with certain information, and all users are provided with 
information about the success or failure of the I/O operation. 

Second, the relationship between the I/O supervisor and the rest of the operating 
system is discussed. The supporting role the control program plays in the performance 
of an I/O operation is entirely different from its role when it is a user. 

The third part of this section describes how the I/O supervisor achieves its objectives. 
To understand how the I/O supervisor functions, one must distinguish carefully 
between what is done to perform an I/O operation, and what is done to coordinate the 
performance of an I/O operation with other I/O operations. A Start I/O instruction, 
for example, would be issued to perform an I/O operation, while a queue representing 
requests that could not be satisfied because needed devices were busy would be 
maintained as a coordinative function. 

In the fourth part of this section, the concept of logical channels is presented. It is a 
prerequisite for the descriptions, in later sections, of how the I/O supervisor queues 
requests for I/O operations. 



The User and the I/O Supervisor 



Three methods a programmer can use to request an I/O operation are shown in Figure 
1. The actions taken by the I/O supervisor in satisfying the request are shown below 
the horizontal line that divides the figure. Specific input data must always be provided 
to the I/O supervisor, but the extent to which the programmer must define that input 
data depends upon the method he is using to request the I/O operation. 

The user of a higher-level language (PL/I, for example) describes files and writes 
OPEN and GET statements. When his program is executed, one PL/I subroutine uses 
a DCB macro instruction to build a data control block (DCB), and an OPEN macro 
instruction to cause data management routines to build a channel program, an 
input/output block (lOB), a data extent block (DEB), and an event control block 
(ECB). Another PL/I subroutine uses a GET macro instruction, and a data 
management routine executes an EXCP macro instruction that causes entry to the I/O 
supervisor. 

Adjacent to the steps taken by a programmer who uses a higher-level language are 
shown the steps a programmer must take when he is using an assembler language and 
chooses to use an access method. This is the path normally taken by control program 
routines. With an access method, a programmer must essentially do what the PL/I 

Section 1: Introduction 3 



compiler did; tiiat is, he must himself write all needed DCB, OPEN, and GET macro 
instructions. 

The user of an EXCP macro instruction must provide directly all of the input that is 
required by the I/O supervisor. He may use the DCB and OPEN macro instructions, 
and he may use the I/O appendages — user-written routines that receive control at 
appropriate exits in the I/O supervisor code — but he must write his own channel 
program, and he must build his own lOB and ECB. To request any kind of I/O 
activity, he must use the EXCP macro instruction. The EXCP user has the option, at 
OPEN time, to specify the use of I/O appendages during the progress of I/O 
operations associated with his data set. These appendages gain control at specific 
points in the EXCP supervisor and the I/O interrupt supervisor. They gain control: 

During extent checking, if an out-of-extent condition is detected 

Prior to issuing the SIO instruction 

If a PCI interrupt is received 

If a normal channel end interrupt is detected 

If any abnormal conditions are detected with a primary interrupt 

The purpose of I/O appendages is to give the EXCP user a means of extending and 
altering I/O operations. For further information about I/O appendages, see OS Data 
Management For System Programmers, GC28-6550. 

Note from Figure 1 how a higher-level language compiler makes use of access method 
routines, and note also the similarity between what is done by access method routines 
and what a programmer must do when he chooses to use the EXCP macro instruction. 



The I/O Supervisor and the Control Program 



There are a number of control program elements involved in I/O operations besides the 
I/O supervisor. For the most part, however, the functions they perform are supporting 
functions needed to coordinate the actions of the I/O supervisor with other system 
actions. The general system environment of the I/O supervisor is shown in Figure 2. 

When an EXCP macro instruction is encountered during assembly of a processing 
program, the assembler obtains the corresponding macro expansion from the 
SYSl.MACLIB data set and inserts it into the object program. The last instruction in 
the EXCP macro expansion is an SVC instruction. 

During execution of the processing program, the SVC instruction causes an SVC 
interruption and immediate entry to the supervisor's SVC first level interruption handler 
(SVC FLIH). The SVC FLIH is always given control after SVC interruptions. It 
refers to a list of SVC numbers (called an SVC table) to determine 1) what SVC 
routine is to service the request and 2) whether or not the needed SVC routine is of 
the type that is contained in main storage. In the case of SVC 0, the routine to be 
given control is always the I/O supervisor's EXCP routine, which is a type 1 SVC 
routine and is contained in the nucleus. 

In giving control to the EXCP routine, the SVC FLIH passes the address of the 
input/output block (lOB), the key item of input data, to the I/O supervisor. 
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Figure 1. The User and the I/O Supervisor 
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Figure 2. The I/O Supervisor and the Control Program 



Using input data it obtains at addresses contained in the lOB, the EXCP supervisor 
either starts the I/O device or, if the needed device is unavailable, schedules the 
request for activity on the device by placing an element representing the request into a 
queue. 

The EXCP supervisor then gives control to the supervisor's type 1 Exit routine. All 
type 1 SVC routines (except those abnormally terminated) pass control to the type 1 
Exit routine. 

If the routine in which the request for the I/O operation was made is still the 
highest-priority task in the system, the type 1 Exit routine restores the environment 
that existed at the time of the interruption and returns control to the requesting routine. 
Alternatively, it passes control to the supervisor's dispatcher routine, which routes 
control to a routine of a new highest-priority task. 
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The next event occurs asynchronously. When the device has completed its part of the 
I/O operation, it causes an I/O interruption. Following I/O interruptions, CPU 
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The I/O FLIH saves a record of the interrupted environment and gives control to the 
second of the two major I/O supervisor routines, the I/O interruption supervisor. 

While the I/O interruption handler processes one interruption, one or more I/O 
operations may occur. Such interruptions are "stacked" — saved by the hardware, thus 
creating a "pending interrupt." The I/O interruption handier processes stacked 
interruptions by enabling twice: before channel restart is attempted and prior to exiting 
to the I/O FLIH. 

The I/O interruption supervisor signals the requestor that the I/O operation is 
completed (the task supervisor's POST routine posts the requestor's event control 
block), and starts other devices on the channel in response to any requests that were 
queued while the device, data set, or channel was busy with the just-completed request. 

The I/O interruption supervisor then returns control to the I/O FLIH and, via the 
dispatcher, control is routed either to the requesting routine or to a routine of a 
higher-priority task. 



The I/O Supervisor 



The overall objective of the I/O supervisor is to make sure that a requested I/O 
operation is performed. To achieve its objective, the I/O supervisor performs three 
major functions: starting I/O operations, terminating I/O operations, and restarting 
I/O operations (for error-correction purposes). These functions, the two major I/O 
supervisor routines and the general control flow to and from the routines, are shown in 
Figure 3. 

The EXCP supervisor is shown twice intentionally. Even though the same routines 
start and restart I/O operations, the two functions are separate and distinct functions 
and are treated separately in the remainder of this publication. 
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Figure 3. I/O Supervision 



The basic control flow to and from the EXCP supervisor and the I/O interruption 
supervisor has already been shown in Figure 2. One exception to the material already 
presented is that, for restarting I/O operations, an SVC 15 instruction (rather than an 
SVC instruction) causes entry to the EXCP supervisor. 
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The same type of diagram is used in Figure 4, where the major functions are expressed 
in more detail, and the three coordinative functions have been added: scheduHng I/O 
operations, starting scheduled I/O operations, and scheduling restarts of I/O 
operations. 

The first flow diagram in Figure 4 shows the flow for a straightforward I/O operation, 
where the Start I/O instruction is accepted and there is no need to schedule I/O device 
activity. This flow is shown separately to illustrate how the request queue is checked 
following completion of every I/O operation. The queue is checked repeatedly until no 
pending requests remain. After terminating an I/O operation, the I/O interruption 
supervisor invokes a user-written or IBM-supplied error correction routine if the status 
indicators show an error conditon to exist. Error routines can request a retry by issuing 
an SVC 15 instruction, which will result in entry to the EXCP supervisor for the retry. 

The second flow diagram in Figure 4 shows the flow for an I/O operation that could 
not be started immediately. Note that the request queue is examined after a restart of 
the I/O operation is scheduled, just as it is when an I/O operation is terminated. 



Concept of Logical Channels 



The queues into which request elements are placed when I/O activity cannot be started 
immediately do not always correspond one-for-one with the physical channels attached 
to a system. Rather, they correspond to what are called logical channels. A logical 
channel is the set of all physical channels by which a device can be reached. 
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Figure 4. I/O Supervisor Functions 



Queuing in logical channel queues makes possible path-device groups in which a 
common set of paths can be tried for each device of a group. The result is simplified 
alternate-path logic. 

Unless a switching device is installed, providing multiple-path capability, every physical 
channel is also a logical channel and there is a one-for-one correspondence. With 
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switching devices, however, the relationship between physical and logical channels 
varies, depending upon both the number of switches and their placement. 

A system with no two-channel switches is shown symbolically at the top of Figure 5. 
Because each device can only be reached via one path, each physical channel is also a 
logical channel. 

Also shown in Figure 5 is a system in which a switching device connects two control 
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B and C are both in the logical channel comprising physical channels 1 and 2. 

Another configuration with a switching device is shown at the bottom of Figure 5. 
This time, devices B, C, and D may be reached via channels 1, 2, and 3; devices B, C, 
and D are all in the same logical channel. 

Except for the 2870 Multiplexor Channel, all devices attached via the same multiplexor 
channel will always be in the same logical channel. The devices attached via a 2870 
Multiplexor Channel may be contained in more than one logical channel, however, 
because each of the four optional selector subchannels is considered separately. 
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Section 1: Introduction 9 



SECTION 2: METHOD OF OPERATION 



This section describes the I/O supervisor in terms of the operations it performs. 
Operation diagrams (Diagrams 1 through 16 at the end of this section) show the 
movement of data through the tables, blocks, work areas, and data sets used by the 
program, and describe the processing performed at each stage. The operation diagrams 
are designed to be used in conjunction with supporting text. 

Operation diagrams are not flowcharts. (Flowcharts are provided in Section 3.) An 
operation diagram shows where information comes from, how it is processed, and 
v/here the results are stored. The diagrams include symbolic names that identify the 
areas of code involved with the operation. 

If you are already famihar with the program, the operation diagrams will act as a recall 
mechanism. If you are learning the program, the diagrams and their supporting text 
will help you to quickly understand the I/O supervisor or the part of the I/O 
supervisor that you are interested in. 
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Overall Operation 



Because the I/O supervisor has access to and can change vital system data, it checks all 
input it receives. Then it builds a control block called a request queue element (RQE) 
to represent the request for I/O activity. When processing of a request must be 
delayed because a device or channel is busy or unavailable, the I/O supervisor places 
the RQE into a queue. When a device is free and a path to the device is open, the 
activity is started. An I/O interruption signals the end of the activity. If it was not 
completed successfully, the I/O supervisor invokes an error routine, which may attempt 
the activity again. 



Validating Input Data 



Before any action is taken on a request for I/O activity, the input data is checked. 
Figure 6 shows what checks are made upon each of the data areas passed to the I/O 
supervisor when I/O activity is requested. 



Scheduling I/O Operations 



To schedule an I/O operation, the I/O supervisor initializes a request queue element 
and links it to the logical channel queue for the channel on which the operation is to be 
performed. 



Initializing a Request Element 



The first major step taken by the I/O supervisor in satisfying a request for I/O device 
activity is to initialize a control block to represent the request. The control block is 
called a request queue element (RQE), and it is initialized to contain pointers to 
information that is used in processing the request. Once an RQE has been initialized, 
it can, by means of a link field, be placed in or removed from any of several request 
queues that are used in coordinating and monitoring the progress of I/O activity. 

A request queue is shown in Diagram 1 as it exists before any requests for I/O device 
activity have been received. Note that the size of the queue is established during 
system generation. 

The NEXAVL (next available) pointer and the TSTLNK fields of individual request 
elements are initiaUzed during assembly of the I/O supervisor control section. The 
NEXAVL pointer contains the address of the first free request element. The TSTLNK 
fields of all but the last element contain the address of the next element; the last 
element contains distinguishing Is in its TSTLNK field. 

The NEXAVL pointer always begins a queue called the freelist. NEXAVL is 
continually updated so as to point to the first available request element, and all free 
request elements are chained via their TSTLNK fields. Before any requests for I/O 
activity are received, all request elements are contained in the freelist. 

The method by which elements are obtained and removed from the freeUst is 
straightforward: the NEXAVL pointer is used to locate the first freehst request 
element, and the element is removed when the TSTLNK field of the selected element is 
placed into NEXAVL. 
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Intercept Processing 



I The addressed device is then checked for an intercept condition. An intercept 
condition is an abnormal condition such as device end and unit check — caused by a 
previous request for the same device. The determination of an intercept condition 
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depends on the setting of the UCB intercept flag. If the flag is on, the intercept 
processing code (INTERR5) begins. It consists of: 

• N'lOVing the saveu i^oVv' status oytes ana tne sense oytes from the uL^ti to the 
input/output block (lOB) associated with the current request. (The status and 
sense bytes are thus available for use by the error recovery routine that may be 
scheduled.) 

• Setting the intercept code (hex. '7E') in the ECB code field of the lOB. The 

nnf\(^ ( n\tcir\0(^r\ tr» Iip>y 'AA'^ \117ill K<=> r»r\ctp»H in tVip> p>^7f»nt cnntrrA K1rvr>V fr\r tVio 

current request, if the intercept condition proves to be uncorrectable. 

• Branching to the dequeue module (XCPPDQ) to remove the request element 
from the request queues. Control is then given sequentially to the user abnormal 
end appendage and the error routine interface (INTERR). If the user has 
selected the use of IBM error recovery procedures, the request element is used to 
schedule an error recovery routine. Otherwise, the request is posted complete 
with permanent error. 

If the flag is off, an intercept condition does not exist, and the appropriate common 
test channel routine (chart AB) is entered. 

See the sections "Testing Channel Availability" and "Starting I/O Devices" for further 
information. 



Queuing a Request Element 



Not all requests for input/output activity can be satisified immediately. When a needed 
device is unavailable because it is being used or because its channel is busy, the request 
element representing the request for the device is placed into a queue. 

To determine whether or not a device is available, the Get Request Element routine 
checks the UCBFLl field of the unit control block for the device, where a record of 
the device's status is maintained (Figure 7). 

There is a queue for every logical channel. Furthermore, there can be up to three ways 
by which a request element can be added to one of the queues, depending upon the 
queuing option selected for the device during system generation: 

• FIFO queuing — it can be added to the end of a queue. RQEs are added at the 
end of the queue in the order in which they occur. 

• Priority queuing — it can be added to a place in a queue determine by the 
requestor's priority. RQEs are added according to the priority of the requested 
task. 

• Ordered Seek queuing — it can be added to a place in a queue determined by the 
seek address. Depending on the access method, RQEs are added according to the 
cylinder address on direct access devices. 

Therefore, the process of queuing a request element includes first selecting one of up to 
three queuing routines and then providing the selected routine with a pointer to the 
queue on which it should place the request element. The mechanism by which the 
selection of a queuing routine and queue combination is achieved is illustrated 
graphically in Figure 8, while a more detailed view of the entire process is shown in 
Diagram 2. Note from Figure 8 how two fields of the unit control block — UCBDTI 
and UCBLCI — are used in selecting the needed combination of queuing routine and 
queue. 
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Starting I/O Operations 



Starting an I/O operation involves: making sure that a path to the device is free; 
preparing a channel program to be executed prior to the requestor's channel program; 
executing the Start I/O instruction; and checking the condition code resulting from the 
Start I/O instruction. 



Testing Channel Availability 



When a device is found to be available, the next step taken is to make sure that a 

(channel by which the device can be reached is available. Byte multiplexor channels are 
not tested, because the Test Channel instruction cannot be used for testing individual 
subchannels. (When any one of the subchannels is free, the response to the Test 
I Channel instruction is channel available.) Selector and block multiplexor channels are 
checked. The checking consists of obtaining the channel's address and using it in a 
Test Channel (TCH) instruction, and then checking the resulting condition code 
(Diagram 3). 

I For each logical channel in the system, there is a unique Test Channel routine entry 
point, and the address of that entry point is contained in the channel's logical channel 
word. When only one path to a device exists, there is a direct relationship between the 
entry point and the channel address. Therefore, at each entry point a predetermined 
constant value can be used for the channel address. The value is placed into a register 
to be used with the Test Channel instruction. 

When alternate paths to a device exist, there are instructions at the Test Channel 
routine entry point which select a channel address from addresses contained in an 
alternate path table. If the first channel selected is found to be busy when the TCH 
instruction is executed, another address is selected. The select-test sequence is 
repeated until an available channel is found, or until all possible paths to the device are 
exhausted. If a channel that is available is found, preparations for starting I/O device 
activity are continued. If there are no free paths to the device, the request is queued. 

One of four condition codes will be set following execution of a TCH instruction. If 
the Interruption Pending in Channel (cc 1) or the Channel Operating in Burst Mode 
(cc 2) condition codes are on, the request element is queued. No distinction is made 
between the Channel Available (cc 0) and the Channel Not Operational (cc 3) 
condition codes. If the channel is not operational, information of a more detailed and 
helpful nature can be obtained by issuing the Start I/O instruction. 



Starting I/O Devices 



When both a device and the channel by which the device can be reached are available, 
the activity requested for the device is begun. There are two major factors that 
influenced the design of the I/O supervisor in this area: differences in the 
characteristics of individual devices; and a need to distinguish between a normal start 
and a restart (as when an error routine is retrying an I/O operation to attempt a 
recovery). The logic involved in allowing for the characteristics of individual devices is 
described here. The operation diagrams and flowcharts do include some restart-related 
information, but this is done to preserve overall continuity of Figures in this 
publication. Restarts are discussed under "Restarting I/O Devices." 
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Allowances need not be made for every type and model of I/O device that can be 
attached to a system. Certain groups, or classes, of devices have common 
characteristics and all devices in a group can be treated alike. There are three device 
classes: 

• Unit-record and communications devices 

• Magnetic-tape devices 

• Direct-access devices 

There is one device-related Start I/O routine for each device class (Charts AD thru 
AI). Each of these makes use of a Start I/O subroutine (Chart AK), which executes 
the Start I/O instruction and, to a limited extent, checks the resulting condition code. 



Unit-Record, Communications, and Graphics Devices 



The logic involved in starting activity on unit record, communications, and graphics 
devices is not complex (Diagram 4 and Chart AD). For immediate operations, which 
involve no transfer of data, a single channel command word (CCW) contained at the 
location named SYSIMD is used. The command code is the only variable, and it is 
obtained from offset 24 of the input/ output block (lOB). The address of the single, or 
"stand-alone," CCW is placed into the channel address word (CAW). Therefore, 
when the Start I/O instruction is executed, the channel will fetch and execute the 
stand-alone CCW. 

For operations involving a transfer of data, the address of the requestor's first CCW is 
placed into the CAW, and the requestor's channel program is fetched and executed by 
the channel after the Start I/O instruction is executed by the CPU. 



Magnetic-Tape Devices 



Except for operations following those in which a cyclic redundancy check was detected, 
the lOS channel program for magnetic tape devices consists of two CCWs: the first 
contains a Set Mode command code (Set Density, Set Parity, etc.), and the second 
contains a Transfer-in-Channel command having as its data address the address of the 
requestor's first CCW (Diagram 5). 

Three CCWs are used for magnetic tape operations following those in which a cyclic 
redundancy check was detected (Diagram 6). The first and third of these contain the 
Set Mode and Transfer-in-Channel commands, respectively. The second CCW 
contains a Track-in-Error command code. 



Direct— Access Devices 



If a direct access device has a movable access mechanism, it must be positioned to the 
required seek address before data transfer can begin. During the time interval needed 
to position the access mechanism, the channel is free to perform I/O operations for the 
other control units attached to it. For this reason, (except for 3330) two seeks are 
issued to service an I/O request to such a direct access device. The first seek is a 
"stand alone seek" — it is not chained to the other CCWs. As soon as the control unit 
receives the seek address, it signals channel end, and the I/O interruption handler can 
start other I/O operations on the channel. The second seek is needed because the 
other I/O operations for the channel may include seek requests for other devices 
connected to the control unit. The second seek reinstates in the control unit the 
address at which data transfer is to begin (the access mechanism of the device will still 
be positioned at the correct address, which was given in the first seek). 
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Except for 3330, the Start I/O instruction is therefore executed twice for direct access 
devices with movable access mechanisms. The first time, the CAW points to the CCW 
for the stand— alone seek. The second time the Start I/O instruction is executed 
(Diagram 7), the CAW points to the first CCW of a three-CCW lOS channel program 
consisting of: the second Seek command; a Set File Mask command for indicating to 
the channel which commands are valid for the current operation; and a 
Transfer-in-Channel command containing the address of the requestor's first CCW. 

XI ct wwiivm-iwii V'Vy\jw \JL \j 10 xw'tuiiiwvt 11 win niv iiioi WA.\^v^wtiV7ii wi Liiv otcii t A/ vy iiiati Ul^LlWll, 

the routine effects a loop with a test I/O (TIO) instruction until the CSW is stored. 
The stored CSW indicates that channel end has occurred and that the seek address has 
been transferred to the head register of the control unit. Then the routine tests for any 
I abnormal conditions received as a result of the TIO instruction. 

The routine tests to see if the access arm has reached its destination (device end). If 
the seek was not completed, the routine either branches to the enqueue routine if I/O 
was entered via the EXCP subroutine, or gets the next request via the channel search 
routine if I/O was entered via the channel restart procedure. If the seek was 
completed, the UCB busy and post flags are turned off indicating that the device has 
reached its destination and that the data transfer operation can be started. 

If the direct access device does not have a movable access mechanism, a stand-alone 
seek is not performed. One Start I/O instruction is executed, and the CAW is made to 
point to the first CCW of the three-CCW channel program shown in Diagram 7. 

Notes: In a Model 65 multiprocessing system that supports shared DASD, the I/O 
supervisor insures that Start I/O instructions for a shared device that 
is reserved are issued via the reserved path and by the CPU that reserved 
the device. 

If the device is a Rotational Position Sensing (RPS) device, lOS does not issue a "stand 
alone seek." After the seek argument is transferred to the control unit, the block 
multiplex channel disconnects from this request and is free to handle other I/O 
requests. When the seek argument has been completed and the block multiplex 
channel is free, the channel reconnects to the original request. In its work area, each 
3330 device has its own Seek command. Set File Mask command, and a 
Transfer-in-Channel command containing the address of the requestor's first CCW. 

2305 SIO Subroutine: The 2305 SIO subroutine is provided to perform those functions 
of the SIO process which are unique to 2305. Refer to the flowcharts for a detailed 
description. 

Upon entry to the 2305 SIO subroutine, the RQE will contain the base address UCB, 
except for those requests which are in an error recovery process. The UCB chain 
pointers are used to search for a free exposure on which this request can be started. 
For non-sequential requests (unrelated), the first available exposure encountered can 
be used. Handling of sequential requests requires that all exposures be checked for an 
available request which is related to this one. If no available related exposure is found, 
the request is started on any available exposure. If no active exposure exists, the 
request is queued. 

Before starting a request on an exposure, the seek address is extent checked, then the 
exposure UCB address is stored into the RQE and the base UCB workarea. Also the 
CAW and system channel program (Seek, Set File Mask, and TIC) are initiahzed for 
this request. 
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The process for starting direct access devices differs in a system that has the Shared 
DASD option. Because a single direct access device is shared between two CPUs with 
this option, special commands are used by the I/O supervisor and the user. Reserve 
and Release are commands used by the I/O supervisor; RESERVE and DEQ are 
macro instructions used by the user. The Reserve command is chained to the I/O 
supervisor channel program when a check of the Reserve Count Field in the UCB 
shows it to be one or greater or when any stand-alone seek is issued. The RESERVE 
macro instruction is issued by the user when he needs exclusive use of a shared direct 
access device. Issuance of the RESERVE macro instruction causes the count in the 
Reserve Count Field of the UCB to be increased by one. The I/O supervisor then 
issues the Reserve command to prevent the second CPU from accessing the shared 
direct access device. The DEQ macro instruction is used by the user to indicate the 
end of his need for exclusive use of the shared direct access device. The DEQ macro 
instruction reduces the count in the Reserve Count Field of the UCB by one. The 
Release command is used by the I/O supervisor when the Reserve Count Field in the 
UCB is zero to free an exclusively used device. 



Checking Condition Codes 



The result of a start I/O instruction is indicated by the condition code that is placed 
into the current program status word (PSW) by the CPU. One of four condition codes 
could appear in a PSW after a Start I/O instruction is executed: 

The I/O activity was begun. 

1 The channel status word (CSW) was stored. 

2 The channel or subchannel is busy. 

3 The channel or control unit is not operational. 

For condition code (the I/O activity was begun) the request queue element for the 
started request is removed from a logical channel queue if it is in one. The request 
queue element would be in a queue if the request was scheduled after a previous 
unsuccessful attempt to start the activity. Once a request has been started, an 
interruption signals to the I/O supervisor that the activity has been completed. At that 
time, the I/O interruption supervisor will be entered (see 'Terminating I/O 
Operations'). 

For condition code 1 (the CSW was stored) the status bits of the CSW are examined. 
Diagram 8 shows which status bits are checked, what events they signify, and what 
actions are taken. 

When the condition code is 2 (the channel or subchannel is busy) the requested I/O 
activity cannot be started because another I/O operation is in progress. The control 
unit busy flag in the UCB is turned on and control is given to the Test Channel routine 
so that another path may be tried. 

A condition code of 3 (not operational) means that due to an equipment failure the 
device or the channel cannot be used. The actions taken when the condition code is 3 
depend upon whether: 

I • The system has the Alternate Path Retry selective retry option. 

• There are alternate paths to the device. 
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An IBM error routine is to be used. 

This is the first occurrence of this condition code 3 on this path. 



Terminating I/O Operations 



When the interruption that signals completion of I/O activity occurs, an indication of 
why the activity stopped appears in the channel status word (CSW). The CSW status 
indicators are checked, and if the activity was completed successfully the requestor's 
RQE is freed. If not, the actions taken depend upon an analysis of the error condition. 

Every tim.e one I/O operation is completed an attempt is made to start other I/O 
operations, including those scheduled to be performed on the same logical channel, and 
also those scheduled for any other logical channels containing the physical channel on 
which the operation was completed. 

I/O interruptions, prevented from occurring during execution of most of the I/O 
supervisor, are allowed to occur before the attempt to start scheduled I/O operations 
and once again after channel restart has been completed. 



Checking Status Indicators 



Except for immediate operations, once activity is started on an I/O device it continues 
until: 

• An error condition causes premature termination. 

• The activity is completed. 

For both cases, the means by which termination of the I/O activity is made known to 
the I/O supervisor is the I/O interruption, and the means by which the I/O supervisor 
can determine what caused termination are status indicators, contained in the channel 
status word (CSW). 

Unlike the case of the Start I/O instruction, where the status information is stored only 
when an exceptional condition occurs, status information is always stored in the CSW 
when an I/O interruption occurs (Part 1 of Diagram 9). Also, the contents of the 
current PSW are stored at the I/O old PSW location. In effect, the CSW shows what 
happened; the PSW shows where it happened. Chart BB shows the CSW bits tested. 

When a channel end status is received and no errors have occurred during the activity, 
the contents of the CSW are moved into the requestor's input/output block (lOB), and 
the requestor's channel end appendage is given control if one is provided. Then the 
requestor's event control block (ECB) is posted complete and his request queue 
element (RQE) is returned to the freelist (Part 2 of Diagram 9). 

If a check of the status shows status or Control Unit End, it is considered a Channel 
Available End and handled as a signal to start a new I/O operation on the associated 
channel. 

Should an analysis of the CSW status bits reveal a unit check, the sense routine 
(INTSEN) is entered (Charts BG and BH). The sense routine constructs and issues a 
sense command to the device in error. It then copies the first two sense bytes into the 
lOB; these are subsequently examined and handled by the appropriate error recovery 
routine. If the shared DASD option is in the system, a read home address and a read 
record commands are chained to the sense command, except for the 2305 and 3330. 
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Furthermore if the Reserve count field is zero, the sense command is changed to a 
RELEASE command — a special type of sense command. This frees the device for use 
by the other CPU. The home address and record data is read into the UCB work 
area. 

If an error occurs after the channel end status is received, it will be too late to act upon 
the completed request, but the next request for activity on the same I/O device will be 
intercepted, and the error condition will be checked at that time (Chart AB, Get 
Request Element Routine). The I/O interruption supervisor locates the UCB address 
of a device in error in one of two ways: by using the last UCB for the channel on 
which the error occurred, or by using the value in the UCB lookup table in an 
algorithm. (See Figure 43 for the algorithm.) 

The actions taken for each type of error depend upon: the nature of the error; the 
context of the error (other conditions detected at the same time); and, in some cases, 
the optional features contained in a system. 



Starting Scheduled I/O Operations 



When a needed device is unavailable at the time a request for I/O activity is received, 
the activity is scheduled. That is, the request element for the request is placed into a 
logical channel queue. While one I/O operation is being performed, a number of 
requests might be received that require scheduUng. An attempt is made to retry all 
such outstanding requests for I/O activity on a channel when an I/O interruption 
occurs and the needed channel becomes available. 

The actions taken to start one or more I/O requests depend upon the type of channel 
made available (multiplexor or selector) and the number of logical channels in which a 
just-freed selector channel is included. The objective is the same, however, regardless 
of what type of arrangement exists — to start processing as many requests as possible. 
To do this, a channel search module provides the Channel Restart routine with the 
address of the logical channel. To provide for overlapped seek and data transfer 
operations (on separate devices), the logical channel is searched twice; once for all 
requests which require seeks, and once for a data transfer operation. When an RQE 
for a device with a movable access-arm is found in the queue, the status of the device 
is tested. If the device is not available, the module searches for the next RQE for a 
device with a movable access-arm. If the device is available, a test channel module is 
entered to determine if the channel is available. 

Each channel has a unique channel search routine, tailored to its channel type and 
channel path arrangement, even though the bulk of the instructions in that channel 
search routine are common to all arrangements and are shared. This is set up during 
system generation, when for each channel there is included one of four unique sets of 
branch instructions to direct CPU control to entry points in the common routine. 
These channel search routines supply addresses of logical channel queues for a 
particular physical channel. With this, the Channel Restart routine obtains the proper 
channel search routine by multiplying the address of the available physical channel by 
four and adding that product to the address of the channel table. The channel search 
routines are shown in charts BM to BP, where no distinction is made between the 
branch instruction group and the common group of channel search instructions. The 
data flow for starting scheduled I/O operations is shown in Diagram 10. 
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Restarting I/O Operations 



When channel status word indicators show that an error occurred during I/O activity, 
an I/O error routine is invoked and a cycle of restarts begins which continues either 
until the error is corrected or until it is declared to be permanent (uncorrectable). This 
cycle is illustrated in Figure 9. The controlling routine of the cycle is the I/O error 
routine v/hi'^h u^on exit ms^' in'^''^^*^'^ ^hat' 

• The activity is to be retried. 

• The error is permanent. 

If the I/O error routine indicates that the I/O activity is to be retried, the I/O 
supervisor returns the request queue element (RQE) to the request queue. The restart 
takes place when the Channel Restart routine, during its normal processing, reaches the 
RQE and passes its address to the EXCP routine. After the I/O activity is completed, 
a series of switches causes control to return to the I/O error routine, even if no errors 
occurred during the retry. 

I/O error routines count the number of retries and indicate to the I/O supervisor that 
the error is permanent when the maximum allowable number has been reached. When 
an I/O error routine indicates that an error condition is permanent, the I/O supervisor 
places a 'permanent error' return code into the requestor's event control block and 
places the RQE into the freelist. 

An error is considered by an I/O error routine to be corrected when no errors occurred 
during a retry of the I/O activity. For corrected errors, the I/O supervisor places a 
'completed without error' code into the requestor's ECB, and continues processing as it 
would have had there been no error the first time the activity was attempted. 

When a data set has been found to be involved in permanent error, none of the related 
requests for that data set should be started. Therefore, before a restart is attempted, 
me Kv^ns lor ine reiaieu requesLs are remuvcu noui lOgicai Cuannei queues, liie 
removal is performed by the I/O Purge routine (IGE0025E), which is invoked after an 
error routine has determined that an uncorrectable I/O error has occurred. The I/O 
Purge routine removes the request elements for the related requests from the logical 
channel queues, Unks the input/output blocks for purged requests in a chain, and posts 
the ECB for each purged request with a 'request element has been freed' code. 



IBM Error Routines 



IBM supphes four types of optional error routines for their customers: 

I device-dependent routines, common routines, outboard-error recording routines, and 
miscellaneous data recording routines. The device-dependent routines are entered after 
either a unit check, a unit exception, a wrong-length indication, a protection check, a 
channel control check, an interface control check, a program check, a chaining check, 
or a channel data check condition as indicated in the CSW status byte. The IBM 
device-dependent error routines attempt error recovery. The common routines, 
comprised of the error interpreter, the write-to-operator routine, and the statistics 
update routine, are used by the device-dependent routines. 
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Figure 9. The I/O Restart Cycle 
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Invoking Error Routines 



The order in which status indicators are checked, and the network of switches that 
controls entry to and exit from I/O error routines are shown in Figure 10. Diagram 11 
shows how an I/O error routine is invoked. 



Device-Dependent Error Recovery Routines 



This section gives a general operating procedure for device-dependent error routines 
and explains the actions of each device-dependent routine. 



General Operating Procedures 



Individual Routines 



Device-dependent error routines gain control from either the contents supervisor in 
MFT systems or the stage-3 exit effector in MVT systems. (For a description of three 
stages of the MVT supervisor, see 05" MVT Supervisor Logic, GY28-6659.) Even 
though each routine has specific characteristics tailored for each device type, the basic 
programming techniques are similar. Each routine sets the lOB error indicator bits, 
examines the sense and CSW status bits that are stored in the lOB to determine the 
type of error, and attempts to recover from the error, if at all possible, by retrying the 
channel program by means of an SVC 15 instruction. 

The lOB exception flag (lOBEX) and error flag (lOBERR) are turned on by all the 
device-dependent error routines. These settings serve a three-fold purpose: both flags 
on indicate that an error routine is in process; lOBEX on and lOBERR off indicate a 
permanent error; and both flags off indicate a successful retry. The tables included for 
each error routine explain the sense bit settings and describe when retry is or is not 
attempted. 

The sense and CSW bits that are stored in the lOB are checked by the device- 
dependent error routines. By checking the lOBFLl field of the lOB, chaining types 
are determined. If the lOBFLl field indicates data and command chaining, no error 
retry is attempted; if it indicates command chaining, error retry is attempted from the 
address of the CCW w^hich caused the error; and if it mdicates data cliauiing or no 
chaining, the error is retried from the first CCW. By checking the CSW status bits in 
the lOB, the error routine determines the type of error that occurred. The bits tested, 
the priority of the testing, and the labels in the error routine to which control goes are 
shown in the tables listed for each device-dependent routine. 

The device-dependent error routines attempt retry of the channel program by issuing 
an SVC 15 instruction. If the retry succeeds, the lOB exception bit and errors flags are 
reset to zero, and normal processing continues. The number of retries attempted 
depends on the device. 

If the CSW status contains a unit check, the device-dependent routine (except for the 
2305 and 3330) gives control to the statistics update routine to update the statistics 
table. 



This section contains information about individual error recovery routines. The 
descriptions are arranged in numerical order according to machine-type. All follow the 
same organization scheme: a brief description of any characteristics of the routine or 
device that could be of use in interpreting the listings; a table, the Error Analysis 
Sequence Table, showing the order of examination of sense and status bits with 
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1052 Error Routine 



pointers to the listings; and a table showing the meanings of lOB sense bits, flags, and 
error count fields for the particular device. 

The tables are to be used as guides in getting to and interpreting the listings, which 
should be considered the final authority. Also: 

• Cross references may sometimes point to approximately where in a listing some 
action is taken. This is because some functions cannot be grouped 'cleanly.' As a 
result, some studying may be required to check fully what happens when a 
particular condition arises. 

• The explanations of sense bit meanings are meant to be quick-reference guides. 
More information can be found in the publications mentioned with each routine. 

• The priority of examination of status and sense bits is a design priority. In some 
cases a variation will be found in the implementation. 

The examination of status and sense bits is usually performed by a small utility-type 
routine called the Error Interpreter routine, which is used in common by the error 
routines. It determines which status or sense bits are on, and returns control to 
requesting error routines at the instruction sequences where the errors can be handled. 

Each time the Error Interpreter routine is entered, it checks one bit. An arrangement 
of offset values and addresses in a hst within the requesting I/O error routine directs 
the Error Interpreter. The list indicates which bits are to be tested and in what order, 
and it also contains the addresses of the instruction sequences to be used for 'on' 
conditions. 

If the system has the Channel Check Handler routine, and a channel error has 
occurred, the error recovery routine that is entered will have available to it an 8-byte 
area called the error recovery procedure interface block. This is produced by the 
Channel Check Handler routine and includes information that could be of use in 
determining whether or not a restart should be attempted. 



Special considerations are necessary for errors on 1052 console typewriters. Messages 
can be issued through the Write-to-Operator routine only for read errors. The 
operator is notified of other types of errors by use of the console alarm bell. 

The 1052 Error routine attempts recovery from channel data checks. When the 
Channel Check Handler is included with a system, the 1052 Error routine also 
examines the error recovery procedure interface block to determine whether it should 
attempt recovery from channel control checks and interface control checks. 

The 1052 Error routine uses bits MO and Ml in the third byte of the lOB flags field to 
control its procedure on subsequent entries after an error. If both bits are set to 0, the 
Error Interpreter routine is used to determine the type of error. If MO has been set to 
1 , a permanent error has occurred and control has been received from the Error EXCP 
routine to ring the console alarm. If Ml has been set to 1, 'intervention required' has 
been signaled, and the original channel program is to be retried. 

The error analysis sequence for the 1052 Printer-Keyboard is shown in Table 1. The 
meanings of the sense bits, lOB flags, and lOB error counts are shown in Table 2. 
More information about the IBM 1052 Printer-Keyboard can be obtained from IBM 
System/ 360 Component Descriptions and Operating Procedures: IBM 1052 
Printer-Keyboard Model 7 with IBM 2150 Console, GA22-6877. 
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Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set when an invaHd command code is detected. The lOB error flag is 
turned off and the lOB exception flag is turned on indicating a permanent error. 
Control is returned to the I/O supervisor via an SVC 15 instruction for abnormal 
termination. 

Bit 1 : Intervention Required 

This bit is set when the printer runs out of forms or when the not-ready key has 
been depressed. The error routine places the control command to ring the 
console alarm in the reposition modifier field of the lOB. The modifier flag 1 is 
set in the lOB to signal the Unit Record SIO routine to build a CCW employing 
this command code. Bit Ml is set in the lOB and control returned by SVC 15. 
The intervention- required condition does not terminate a read or write operation 
that is already in progress. 

Bit 2: Bus-Out Check 

This bit is set when a '^arity error is detected on a command or data bvte. The 
error routine sets the bus-out flag in the lOB and retries the user's channel 



Table 1. IBM 1052 Printer-Keyboard Error Analysis Sequence (Module IGEOOOOD) 





Status 


Sense 




Applicable to: 




Priority 


Bit 


Byte 


Bit 


Condition 


Read 


Write 


Pointer 


1 


45 






Channel Control Check 


X 


X 


ERR530 


1 


46 






Interface Control Check 


X 


X 


ERR530 


2 


47 






Chaining Check 


X 


X 


ERR524A 


3 


38 






Unit Check 


X 


X 


ERR501 


4 







7 


Should Not Occur 


X 


X 


ERR504 


5 







6 


Should Not Occur 


X 


X 


ERR504 


6 







5 


Should Not Occur 


X 


X 


ERR504 


7 







4 


Should Not Occur 


X 


X 


ERR504 


8 







3 


Equipment Check 


X 


X 


ERR506 


9 







1 


Intervention Required 


X 


X 


ERR509 


10 







2 


Bus-Out Check 


X 


X 


ERR510 


11 










Comnnand Reject 


X 


X 


ERR518A 


12 


44 






Channel Data Check 


X 


X 


ERR525 


13 


42 






Progrann Check 


X 


X 


ERR518A 


14 


43' 






Protection Check 


X 


X 


ERR518A 


15 


39 






Unit Exception 


X 




ERR518B 


16 


41 






Incorrect Length 


X 


X 


ERR518A 


See page 


27 for an explanation of the 


pointers. 
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BitO 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


















lOBFLl 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 
in 
Control 


Modifier 
F!cg 1 




Exceptional 




Start 

1 Roitcrt 






iOBFL3 






Write 
Error 
Count 


Bus-Out 

Error 

Count 


Control 

Bit 

Ml 


Message 
Type 


Control 

Bit 

MO 


Logout 
Flag 






Error Counts 
lOBECT 
Byre 1 










Multiple 
Console 
Support Retry 


Multiple 
Console 
Support Retry 


Multiple 
Console 
Support Retry 


Channel Data 
Check and 
MCS Retry 








Error Counts 
lOBECT 
Byte 2 
















Channel Control 
Check, Interface 
Control Check 















program via SVC 15. If the error recurs, the control command to ring the 
console alarm is placed in the reposition modifier field of the lOB, and modifier 
flag 1 is set to signal the Unit Record SIO routine to construct a CCW with this 
command. lOB bit MO is set and control returned via SVC 15. Five retries are 
attempted on console devices of systems with multiple console support. 

Bit 3: Equipment Check 

This bit is set when one of the following occurs: 

• Keyboard parity error. 

• Keyboard-printer compare check. 

• Printer failed to take a mechanical cycle during a read or write operation. 

If the error occurred on a read command, a permanent error is assumed and the 
Write-to-Operator routine is invoked; it writes a message (lEAOOOI) indicating 
failure to read input messages. For write errors, the error routine retries the 
channel program via SVC 15. On the second occurrence of the error, the console 
bell is rung via the procedure described above for bus-out check. Five retries are 
attempted on console devices of systems with multiple console support. 

Bits 4-7: Should Not Occur 

If any of these bits is set, a catastrophic error is assumed. A permanent error is 
signaled to the Unit Record SIO routine and control is returned via SVC 15. 
Five retries are first attempted on console devices of systems with multiple 
console support. 
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1285, 1287 and 1288 Error Routines 



The 1285 Error routine (module IGEOOUB), 1287 Error routine (module IGEOOllC), 
and the 1288 Error routine (module IGEOOllD) all attempt recovery from channel 
data checks. When the Channel Check Handler is included with a system, they also 
examine the error recovery procedure interface block to determine whether they should 
attempt recovery from channel control checks and interface control checks. 

The error analysis sequence for the IBM 1285 Optical Reader is shown in Table 3, and 
the error analysis sequence for the IBM 1287 and 1288 Optical Readers is shown in 
Table 4. The meanings of sense bits, lOB flags, and lOB error counts for the three 
devices are shown in Table 5. More information can be obtained from the following 
publications: 

• IBM 1285 Optical Reader Component Description and Operating Procedures 
GA24-3256 

• IBM 1287 Optical Reader Component Description and Operating Procedures, 
GA2 1-9064 

• IBM 1288 Optical Page Reader Model 1 Component Description, 
GA2 1-9081 



Table 3. IBM 1285 Optical Reader Error Analysis Sequence (Module IGEOOl IB) 





Status 


Sense 






Priority 


Bit 


Byte 


Bit 


Condition 


Pointer 


1 


45 






Channel Control Check 


ERR0041 


2 


46 






Interface Control Check 


ERR0041 


3 


44 






Channel Data Check 


ERR0041 


3 


33 






Status Modifier 


ERR0041 


3 


34 






Control Unit End 


ERR0041 


4 


38 






Unit Check 


ERR0041 


5 







3 


Equipnnent Check 


ERR006C 


6 







1 


Intervention Required 


ERR006C 


7 







6 


Non-Recovery 


ERR006C 


8 







2 


Bus-Out Check 


ERR006C 


9 







4 


Data Check 


ERR006C 


10 







5 


Overrun 


ERR006C 


11 










Command Reject 


ERR006C 


12 


47 






Chaining Check 


ERR04B1 


13 


42 






Program Check 


ERR04B1 


14 


43 






Protection Check 


ERR04B1 


15 


41 






Incorrect Length 


ERR04B1 


See page 


27 for an explanation of the 


pointers. 
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labie 4. IBM 1287 and 1288 Optical keaaers tirror Analysis sequence 





Status 


Sense 






Priority 


Bit 


Byte 


Bit 


Uondition 


Pointer 


1 


45 






Channel Control Check 


ERR0041 


2 


46 






Interface Control Check 


ERR.0041 


3 


44 






Channel Data Check 


ERR0041 


4 


32 






Control Unit End 


ERR0041 


5 


38 






Unit Check 


ERR0041 


6 




1 


3 


Should Not Occur 


ERR006 


6 




1 


5 


Should Not Occur 


ERR006 


6 




1 


6 


Should Not Occur 


ERR006 


6 




1 


7 


Should Not Occur 


ERR006 


7 




1 





Tape Mode (1287 only) 


ERR006 


8 







7 


Should Not Occur 


ERR006 


9 







3 


Equipment Check 


ERR006C 


10 







6 


Non-Recovery 


ERR006C 


11 







1 


Intervention Required 


ERR006C 


12 







2 


Bus-Out Check 


ERR006C 


13 







4 


Data Check 


ERR006C 


14 







5 


Overrun 


ERR006C 


15 










Connmand Reject 


ERR006C 


16 




1 


4 


Invalid Operation 


ERR006C 


17 


47 






Chaining Check 


ERR004B1 


18 


42 






Program Check 


ERR004B1 


19 


43 






Protection Check 


ERR004B1 


20 


41 






Incorrect Length 


ERR004B1 


See page 


27 for an ex 


planation of the 


pointers. 





ScRSS B^t6 ]Vl63R!R"S 

Byte 0, Bit 0: Command Reject 

This bit is set when the command is incorrect for the operating mode, such as a 
Mark Line command in document mode or a normal command in CE diagnostic 
mode. An invalid command sequence, such as two consecutive ejects, will also 
cause the bit to be set. 

Byte 0, Bit 1 : Intervention Required 

This bit is set when the device is not in ready status. 

Byte 0, Bit 2: Bus-Out Check 

This bit indicates that invalid parity has occurred in a command or data. 
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Table 5. IBM 1285. 1287. and Optical Readers Sense Bits, lOB Flags, and lOB Error Counts 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
Required 


Bus- Out 
Check 


Equipment 
Check 


Data 
Check 


Overrun 


Non- 
Recovery 


Keyboard 
Correction 
(1285, 1287 
Tape Mode 
Only) 


Sense Byte 1 
(1287, 1288 Only) 


Tape Mode 
(1287 Only) 


Late SS 
or End of 
Page 


No 

Document 

Found 




Invalid 
Operation 
















lOBFLl 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL3 












Message 
Type 




Logout 
Flag 














lOBINCAM 
(Byte 1) 


Data Check Count 


lOBINCAM 
(Byte 2) 






Incorrect Length Count 








lOB 

Error Counts 

Byte 1 


Equipment Check Count 


lOB 

Error Counts 

Byte 2 


Overrun 


Error Count 




Bus-Out 
Count 


Chainin 


g Check Count 





Byte 0, Bit 3: Equipment Check 

One of the following has occurred: (1) the device was unable to completely read 
a line or field, (2) the 1287 or 1288 could not locate the reference mark, or (3) 
the 1288 failed to find a timing mark. 

Byte 0, Bit 4: Data Check 

The optical reader has sent at least one reject character or substitute character. 
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Byte 0, Bit 5: Overrun 

An overrun condition occurs when the channel fails to service the optical reader 



Byte 0, Bit 6: Non-recovery 

The operator must reload and restart the optical reader because (1) the document 
or tape is jammed, (2) the runout key was depressed while a document or tape 
was being processed, or (3) the scanner door was open when the device was not 
in the line display mode. 

Byte 0, Bit 7: Keyboard Correction 

The 1287 or 1285 has displayed at least one unreadable character for online 
correction. 

Byte 1, Bit 0: Tape Mode 

The 1287 Model 2 is operating in the tape mode. 

Byte 1, Bit 1: End of Page (1288) 

The bottom of the page has been detected while reading in the unformatted 
document mode. 

Byte 1, Bit 1: Late Stacker Select (1287) 

The Stacker Select command did not arrive in time and the document was placed 
into the reject stacker. 

Byte 1, Bit 2: No Document Found 

A document did not enter the reading station after the last eject command and 
there was no jam. 

Byte 1, Bit 3: Not Used 

Byte 1, Bit 4: Invalid Operation 

Invalid information was specified in the load format instruction. For example: 
bit 2, 3, 4, or 5 of the fourth byte represents bits not used; fewer than four bytes 
were transmitted; or an uninstalled font was specified in the CCW. 

Byte 1, Bits 5—7: Not Used 



1403 and 1443 Error Routine 



The 1403 and 1443 Error routine attempts recovery from the special condition where 
channel data checks occur with bus-out checks. When the Channel Check Handler is 
included with a system, the 1403 and 1443 Error routine also examines the error 
recovery procedure interface block to determine whether it should attempt recovery 
from channel control checks and interface control checks. 

The error analysis sequence for the 1403 Printer and the 1443 Printer is shown in 
Table 6. The meanings of sense bits, lOB flags, and lOB error counts are shown in 
Table 7. More information about the IBM 1403 and 1443 Printers can be obtained 
from the following pubUcations: 

IBM 1403 Printer Component Description, GA24-3073 

IBM 1443 Printer Models 1 to 4 and Nl; IBM 1445 Printer Models 1 
and Nl, GA24-3120 
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Table 6. IBM 1403 Printer and 1443 Printer Error Analysis Sequence (Module 
IGEOOOOG) 



Priority 

1 
1 
2 
3 
4 
5 
6 
7 



Status 
Bit 



Sense 
Byte Bit 






6 





3 





1 





2 





7 









Condition Pointer 

45 Channel Control Check ERR051 

46 Interface Control Check ERR051 

47 Chaining Check ERR071 
38 Unit Check ERR053 

Should Not Occur ERR052F 

Equipnnent Check ERR052F 

Intervention Required ERR054 

Bus-Out Check ERR056 

Channel 9 ERR059 

9 Command Reject ERR052E 

10 44 Channel Data Check ERR067 

11 42 Program Check ERR063 

12 43 Protection Check ERR063 

13 39 Unit Exception ERR064 

14 41 Incorrect Length ERR068 

See page 27 for an explanation of the pointers. 

The sequence shown above is for the 1403 without the Universal Character Set (UCS) feature, and 
for the 1443. 

For 1403s with UCS, bits 4 and 5 of sense byte mean 'data check' and 'parity check,' respectively. 
Their priority falls between 9 and 10 and 5 and 6, respectively. 

9.1 4 Data Check ERR052E 

5.1 5 Parity Check ERR052D 



Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set when one of the following occurs: 

• A Read Backward command is received. 

• A carriage instruction to space more than three lines is received. 

• A carriage instruction to skip to channel 0, 13, 14, or 15 of the carriage 
control tape is received. 

• Any command is received which the device is not designed to execute. 
The error is considered permanent. 
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IBM 1403 Printer and 1443 Printer Sense Bits, lOB Flacs, and TOB Frror Counts 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
Required 


B.J5-Out 

Check 


Equipment 
Check 


Data y^ 

Check / 

^/Typebar 
y^ Selection 


Parity y/^ 

Error / 

>/ Typebar 
X Selection 




Channel 9 




lOBFLl 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








I0BFL3 




Entry 
Bit 


UCS Parity 

Error 

Count 


Bus-Out 
or Channel 
Data Check 
Error 
Count 




Message 
Type 




Logout 
Flag 








Error Counts 
lOBECT 
Byte 1 










Multiple 
Console 
Support Retry 


Multiple 
Console 
Support Retry 


Multiple 
Console 
Support Retry 


Multiple 
Console 
Support Retry 










Error Counts 
lOBECT 
Byte 2 
















Channel Control 
Check, Interface 
Control Check 

















Bit 1 : Intervention Required 

This bit indicates a not-ready condition due to one of the following: 

• The printer has run out of forms or the forms have jammed. 

• The Stop Key has been depressed. 

• The cover interlock switch is open. 

• The typebar motor switch is set to the OFF or REMOVE position. 

When this bit and bit 7 (Channel 9) are on, the error is handled as a Channel 9 
condition. In all cases, an Intervention Required message is issued to the 
operator who must correct the condition. When the intervention required 
condition alone is corrected, the last operation is repeated. 

Bit 2: Bus-Out Check 

This bit indicates that a parity error has occurred on a bus-out command or data 
byte. If this bit is set during the initial selection of a control unit or a device, the 
operation is retried. If it is set during channel end, the error is automatically 
considered permanent unless it occurs on the console device of a system having 
the Multiple Console Support feature, where it is retried five times. 

Bit 3: Equipment Check 

This bit indicates that a program-correctable malfunction was detected in the 
printer or in its controls. The malfunctions are buffer or hammer checks on the 
1403 and typebar-synchronization errors on the 1443. These errors are reset by 
the next Write or Control command. Five retries are attempted on systems with 
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multiple console support before the error is considered permanent, if the printer is 
being used as a console. Otherwise, the error is considered to be permanent, and 
no retry is attempted. 

Bit 4: Data Check (1403 Only) 

If the 1403 has the Universal Character Set (UCS) feature, this bit is set when a 
code in a data record sent to the printer does not match a code in the UCS 
feature storage. (Without UCS, this bit should not be set.) The error is 
automatically considered permanent unless it occurs on the console device of a 
system having the Multiple Console Support feature, where it is retried five times. 

Bit 5: Parity Error (1403 Only) 

If the 1403 has the Universal Character Set (UCS) feature, this bit indicates a 
parity error was detected in data being written into or read from UCS feature 
storage. If the error occurs while the UCS storage is being loaded, one retry is 
attempted. If it occurs at any other time, the error is considered permanent. In 
systems having the Multiple Console Support feature, five retries are attempted 
lOr consoic ue vices. 

Bits 4 and 5: Typebar Selection (1443 Only) 

The combination of these two bits indicates the position of the typebar selector 
switch. 

Bit 4 Bit 5 Switch Setting 

52-character set 
13 -character set 
39-character set 
63-character set 

These bits can be changed only by repositioning the typebar selector switch. 
They are considered normal, and error routine coninues the channel program. 

Bit 6: Should Not Occur 

If this bit is set, a catastrophic error is assumed. The logout flag is set in the lOB, 
a permanent error is signaled to the Error EXCP routine, and control is returned 
via SVC 15. 

Bit 7: Channel 9 

This bit is set when a hole is sensed in channel 9 of the carriage control tape. 












1 


1 





1 


1 



1419/1275 Error Routine 



The 1419/1275 Error routine attempts recovery from channel data checks. When the 
Channel Check Handler is included with a system, the 1419/1275 Error routine also 
examines the error recovery procedure interface block to determine whether it should 
attempt recovery from channel control checks and interface control checks. 

The error analysis sequence for the IBM 1419/1275 Magnetic Character Reader is 
shown in Table 8. The meanings of sense bits, lOB flags, and lOB error counts are 
shown in Table 9. Sense byte 2 is applicable only to the secondary control unit of 
systems with the Dual Address Adapter feature. 



36 OS I/O Supervisor Logic 



More information can be obtained from the following publications: 

* lulri IZl" riCUUVr iJiUntT, iDlVi 1 -r 1 :7 iriugricin. \^riUfULlCf IXCUUCr, 

GA24-1499 

IBM 1419 Magnetic Character Reader and IBM 1275 Optical Reader 
Sorter, Device-Dependent BSAM Program Logic Manual, GY21-0012 



Table 8. IBM 1419/1275 Magnetic Character Reader Error Analysis Sequence 
(Module IGEOOllE) 



Priority 

1 
2 
3 
4 
5 



9 

10 
11 
12 
13 
14 
15 
16 



Status 


Sense 




Bit 


Byte 


Bit 


Condition 


45 






Channel Control Check 


46 






Interface Control Check 


44 






Channel Data Check 


38 






Unit Check 







3 


Should Not Occur 







7 


Document Spacing Error 







1 


Intervention Required 







2 


Bus-Out Check 







4 


Data Check 







5 


Overrun 







6 


Auto Select 










Command Reject 


47 






Chaining Check 


42 






Program Check 


43 






Protection Check 


41 






Incorrect Length 



Pointer 

ERR020 
ERR020 
ERR020 
ERR020 
ERR051 
ERR051 
ERR051 
ERR051 
ERR051 
ERR051 
ERR051 
ERR051 
ERR069 
ERR069 
ERR069 
ERR069 



For the secondary control unit, the following sense bytes are examined in place of those shown 



5 

6 

7 

8 

9 

10 

11 

12 



2 


2 


Bus-Out Check 


ERR061 


2 


4 


Should Not Occur 


ERR061 


2 


3 


Should Not Occur 


ERR061 


2 


1 


Intervention Required 


ERR061 


2 


7 


Operator Attention 


ERR061 


2 





Command Reject 


ERR061 


2 


5 


Late Stacker Select 


ERR061 


2 


6 


Auto Select 


ERR061 



See page 27 for an explanation of the pointers. 
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Table 9. IBM 1419/1275 Magnetic Character Reader Sense Bits, lOB Fiaes, and lOB Error Counts 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense B/te 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 




Data 
Check 


Overrun 


Auto- 
Select 








Sense Byte 1 






Document 
Under 
Read Head 


Amount 
Field 

Valid 


Process 
Control 
Field Volid 


Account 
NLTTiber 
Field Valid 


Transit 

Field 

Valid 


Serial 
Number 
Field Valid 






Sense B/te 2 
(Secondary 
Control Unit Only) 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 






Late 
Stacker 


Auto- 
Select 


Operator 
Attention 






lOBFLl 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 

Control 






Exceptional 
Condition 














IOBFL2 




Sense 
Bit 


Purge 
Flag 
























IOBFL3 












Permanent 
Error 




Logout 
Flag 















IBM 1419/1275 Magnetic Character Reader Sense Byte Meanings 

Byte 0, Bit 0: Command Reject 

This bit is set when an invalid command is received. Invalid commands include: 

• Two Read commands without an intervening Stacker Select command when 
the 1419 is in program-sort mode 

• A Stacker Select command given for an auto-selected document 

• A second Stacker Select command after one has been accepted for a 
document 

• A Write command given when the machine is not in diagnostic mode 
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Byte 0, Bit 1 : Intervention Required 

This bit indicates that operator attention is needed for one or more of the 
following reasons: 

Document jam 

Full stacker 

Sort-check 

Endorser stop 

End-of-transport stop 

Film stop 

Batch number advance check stop 

Motor not running 

Byte 0, Bit 2: Bus-Out Check 

This bit is set for parity errors on information coming from the CPU via the 
interface. 

Byte 0, Bit 3: Should Not Occur 

Byte 0, Bit 4: Data Check 

This bit indicates that one or more of the selected fields in the document was not 
read correctly. 

Byte 0, Bit 5: Overrun 

This bit is set when a character is not accepted. The field containing the error is 
identified by a in bits 3 to 7 of sense byte 1. 

Byte 0, Bit 6: Auto-Select 

This bit is set when a document is automatically selected into the reject pocket. 
A 51-column card turns the indicator on if the 51-column feature is not installed. 
If a Stacker-Select command is issued for an auto-selected document, the 
command reject bit will be set. 

Byte 0, Bit 7: Should Not Occur 

Byte 1, Bit 0: Should Not Occur 

Byte 1 , Bit 1 : Should Not Occur 

Byte 1, Bit 2: Document Under Read Head 

This bit is normally used in diagnostic mode only. 

Byte 1, Bit 3: Amount Field Valid ^ 

Byte 1, Bit 4: Process Control Field Valid ^ 

Byte 1, Bit 5: Account Number Field Valid ^ 

Byte 1, Bit 6: Transit Field Valid i 

Byte 1, Bit 7: Serial Number Field Valid ^ 



When this field is selected at the operator panel, and is read without error (including symbols), the bit is set to one. 
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Byle 2 (Secondary Control Unit Only): 

Byte 2, Bit 0: Command Reject 

This bit is set when an invalid command is received by the secondary control unit 
(SCU). The following commands are considered invalid in the SCU: 

• Read 

• Read Backwards 

Write 

Byte 2, Bit 1 : Intervention Required 
See byte 0, bit 1. 

Byte 2, Bit 2: Bus-Out Check 

This bit is set for parity errors on information coming from the CPU via the 
interface. 

Byte 2, Bit 3: Should Not Occur 

Byte 2, Bit 4: Should Not Occur 

Byte 2, Bit 5: Late Stacker Select. 

This bit is set when a Stacker-Select command is given for a document which has 
passed the select station. The document is rejected. 

Byte 2, Bit 6: Auto-Select 

This bit is set when a Stacker-Select command is issued for a document that is 
auto-selected. 

Byte 2, Bit 7: Operator Attention 

This bit is set when the Update switch is off and a Stacker-Select command is 
issued to effect batch-numbering update. 



1442, 2501, and 2520 Error Routine 



The 1442, 2501, and 2520 Error routine attempts recovery from channel data checks 
on 1442, 2501, and 2520 read errors. Each read operation is retried once. 

The error analysis sequence for the IBM 1442 Card Read Punch, 2501 Card Reader, 
and 2520 Card Read Punch is shown in Table 10. The meanings of the sense bits, 
lOB flags, and lOB error counts are shown in Table 11. More information about the 
individual devices can be obtained from the following publications: 

• IBM 1442-Nl and N2 Component Description and Operating Procedures, 
GA2 1-9025 

• IBM 2501 Models Bl and B2 Component Description and Operating 
Procedures, G A2 1 -9026 

• IBM 2520-Bl, B2, and B3 Component Description and Operating 
Procedures, G A2 1 -9027 
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laDie lu. it3M 1442 Card Read Punch, ZJUi Uaru Header, and zSzO Card Kead 
Punch Error Analysis Sequence (Module IGEOOOOE) 





Status 


Sense 






ority 


Bit 


Byte 


Bit 


Condition 


Pointer 


1 


4b 






Channel Controi Check 


ERR002 


1 


46 






Interface Control Check 


ERR002 


2 


38 






Unit Check 


ERR002 


3 







6 


Should Not Occur 


ERR004 


4 







3 


Equipment Check 


ERR008 


5 







7 


Should Not Occur 


ERR004 


6 







1 


Intervention Required 


ERR036 


7 







2 


Bus-Out Check 


ERR013 


8 







4 


Data Check 


ERR017 


9 







5 


Overrun 


ERR020 


10 










Command Reject 


ERR006 


11 


44 






Channel Data Check 


ERR035 


12 


47 






Chaining Check 


ERR029 


13 


42 






Program Check 


ERR029 


14 


43 






Protection Check 


ERR029 


15 


39 






Unit Exception 


ERR029 


16 


41 






Incorrect Length 


ERR029 



See page 27 for an explanation of the pointers. 



Table 11. IBM 1442 Card Read Punch, 2501 Card Reader, and 2520 Card Read Punch Sense Bits, lOB 
Flags, and lOB Error Counts 





Bit 


1 1 

Bit 1 


Bit 2 


Bits 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


Data 
Check 


Overrun 










lOBFLl 


00 No Chaining 

01 Command Chaining 
10 Data Chaining 

] 1 Command and 
Data Chaining 


Error 
Routine 
in 
Controi 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL3 




Entry 
Bit 


Read 
Error 
Count 


Bus-Out 

Error 

Count 


Data 

Check 

Flag 


Message 
Type 


Overrun 
Count 


Logout 
Flag 
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Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set when a Read Backward command is issued, or when any other 
command is received which the device has not been designed to execute. The 
error is considered permanent. 

Bit 1 : Intervention Required 

This bit is set when one of the following occurs: 

The power is off. 

Cards are not registered at the read station. 

The stacker is full. 

The feed check light is on. 

The stop key has been depressed. 

The chip box is full, or has been removed. 

There are no cards in the hopper and the End-of-File light is not on. 

The cover interlock switch is open. 

A message is given the operator, who must take action. Upon correction of the 
condition, the interrupted operation is repeated. 

Bit 2: Bus-Out Check 

This bit is set when a parity error has occurred on bus-out during transfer of 
command or data bytes, but not during the time period of address-out or 
command-out proceed. For a command byte one retry is attempted. If the error 
is not corrected it is considered permanent. For a data byte, the card is already 
punched and the error is considered permanent. However, on a 2501, the error is 
automatically retried once. 

Bit 3: Equipment Check 

This bit is set when one of the following occurs: 

• An invalid card code is detected during a punch operation. 

• During a read or punch operation an error is detected during the 9-bit 
match. 

The invalid card code part of equipment check is not set during card image punch. 

If the error occurs during a punch operation other than QSAM, it is automatically 
considered permanent. With QSAM an error occurring during a punch operation 
is retried. If it occurs during a read operation, one retry is attempted. 

Bit 4: Data Check 

This bit is set when an invalid card code is detected during a read operation. This 
error pertains to the last card for which data was sent. A message is typed and 
an operator must reposition the cards for one retry. If the error persists, it is 
considered permanent. 
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2250 Error Routine 



Tabic 12. 


IBM 


2250 


Dispb 


ly Unit 




{Module 


IGEOOIC 


^A) 




Status 


Sense 




Applicable to 




Priority 


Bit 




Byte 


Bit 


Condition 


2250-1 


2250-2 


Pointer 


1 


45 








Channel Control Check 


X 


X 


ASRON 




A r' 
HO 








inierface Control Check 


X 


X 


ASRON 


3 


44 








Channel Data Check 


X 


X 


TESTST 


4 


38 








Unit Check 


X 


X 


MAINER 


5 









1 


Should Not Occur 


X 




SEROUT 


5 









3 


Should Not Occur 


X 


X 


SEROUT 


5 









5 


Should Not Occur 


X 


X 


SEROUT 


5 









7 


Should Not Occur 


X 


X 


SEROUT 


6 









2 


Bus-Out Check 


X 


X 


B01CHK 


7 









4 


Data Check 


X 


X 


DATACX 


8 












Command Reject 


X 


X 


PERMER 














Command Reject 


Note 1 




PERMER 


9 









6 


Buffer Running 


X 


X 




10 


42 








Program Check 


X 


X 


PERMER 


11 


43 








Protection Check 


X 


X 


PERMER 


12 


41 








Incorrect Length 


X 


X 


PERMER 



See page 27 for an explanation of the pointers. 

Note: For an unbuffered 2250 Model 1 the following changes are necessary; 

a. Command Reject with Buffer Running is a 'Should Not Occur' condition with Priority 5, Pointer 
SEROUT. 

b. Priorities 10, 11, and 12 become 9, 10, and 11, respectively. 



Bit 5: Overrun 

This bit is set if during a read operation the interface has not transmitted a 
character by the time the next character is to be read into the register. The 
operator must reposition the cards. The operation is retried once and if the error 
persists it is considered permanent, and a message is written to the console. 

Bits 6 and 7: Should Not Occur 

If either of these bits is set, a catastrophic error is assumed. A permanent error is 
signaled to the Error EXCP routine and control is returned via SVC 15. 



The 2250 Error routine attempts recovery from channel data checks. When the 
Channel Check Handler is included with a system, the 2250 Error routine also 
examines the error recovery procedure interface block to determine whether it should 
attempt recovery from channel control checks and interface control checks. 

The error analysis sequence for the IBM 2250 Display Unit is shown in Table 12. The 
meanings of sense bits, lOB flags, and lOB error counts are shown in Table 13. More 
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information about the IBM 2250 Display Unit can be obtained from the following 
publications: 

• IBM System/360 Component Description: IBM 2250 Display Unit Model I, 

GA27-2701 

• IBM System/360 Component Description: IBM 2250 Display Unit Model 2, 
IBM 2840 Display Control Model I, G All -21 02 



Table 13. IBM 2250 Display Unit Sense Bits, lOB Flags, and lOB Error Counts 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 




Bus-Out 
Check 


Equipment 
Check 
(Model 2) 


Data 
Check 




Buffer 
Running 










Sense Byte 1 


Liaht 

Pen 

Defect 


End 

Order 

Sequence 


Character 
Mode 






2840 

Output 

Check 


2840 
Input 
Check 










lOBFLl 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and Data 
Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL2 


Halt I/O 
Issued 


Sense 
Flag 










Film 
Unit 
Flag 














IOBFL3 












Message 
Type 




Logout 
Flag 














lOB 

Error Counts 

Byte 1 


Bus-Out 1 

Retry 

Indicator 


Bus-Out 2 

Retry 

Indicator 


Date 
Check 


Equipment 
Check 


2840 
Input 
Check 


2840 

Output 

Check 


Abnormal 
End 

Appendage 
Bit 


Channel 

Data 

Check 


lOB 

Error Counts 

Byte 2 


Interface 

Control 

Check or 

Channel 

Control 

Check 































Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set when there is an invalid modifier bit in a command or an invalid 

invalid command sequence. The error is considered permanent. 
Bit 1 : Should Not Occur 

When this bit is set, a catastrophic error is assumed. The logout flag in the lOB is 

set and the permanent error procedure is performed. 
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Bit 2: Bus-Out Check 

This bit is set when a parity error is detected on a command or data byte during 
bus-out. The operation is retried once. If the retry is unsuccessful, a message is 
written to the operator. 

Bit 3: Equipment Check (Model 2); Should Not Occur on Others (See Bit 1). 

Bit 4: Data Check 

This bit is set when a buffer parity error is detected either during a read operation 
or during image regeneration. The operation is retried once. If the retry is 
unsuccessful, a message is written to the operator. 

Bit 5: Should Not Occur (See Bit 1) 

Bit 6: Buffer Running 

This bit indicates that regeneration is in process. When accompanied by 
Command Reject, a permanent error is assumed. 

Bit 7: Should Not Occur (See Bit 1) 



Table 14. IBM 2260 Display Station and 1053 Printer Error Analysis Sequence (Load 1— IGEOOIOB or 
Load2— IGEOllOB) 



Load^ 



ority 


Status 
Bit 


Sense 
Byte Bit 


Condition 


Applicable to 
2260 1053 


Pointer L 


1 


45 






Channel Control Check 


X 


X 


ASRON 1 


2 


46 






Interface Control Check 


X 


X 


ASRON 1 


3 


44 






Channel Data Check 


X 


X 


TESTST 1 


4 


38 






Unit Check 


X 


X 


MAINER 1 


5 







4 


Should Not Occur 


X 


X 


SEROUT 1 


5 







5 


Should Not Occur 


X 


X 


SEROUT 1 


5 







6 


Should Not Occur 


X 


X 


SEROUT 1 


6 







3 


Equipment Check 


X 




EC 1 


7 







1 


Intervention Required 




X 


2260-SEROUT 1 
1055-vvOPOST 


8 







2 


Bus-Out Check 
Initial Selection 


X 


X 


B01 1 


8 







2 


Bus-Out Check 
Data Transfer 


X 




ISBUSOUT 1 


8 







2 


Bus-Out Check 
Data Transfer 




X 


ISBUSOUT 1 


9 










Command Reject 


X 


X 


PERMER 1 


10 


42 






Program Check 


X 


X 


PERMER 1 


11 


43 






Protection Check 


X 


X 


PERMER 1 


12 


41 






Incorrect Length 


X 


X 


PERMER 1 



Only first— time equipment check errors are handled by load 2. 

See page 27 for a explanation of the pointers. 
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2260 and 1053 Error Routine 



The 2260 and 1053 Error routine attempts recovery from channel data checks. When 
the Channel Check Handler is included with a system, the 2260 and 1053 Error 
routine also examines the error recovery procedure interface block to determine 
whether it should attempt recovery from channel control checks and interface control 
checks. 

The error analysis sequence for the IBM 2260 Display Station and IBM 1053 Printer is 
shown in Table 14. The meanings of sense bits, lOB flags, and lOB error counts are 
shown in Table 15. More information about the IBM 2260 Display Station and 1053 
Printer can be obtained from the publication IBM System/360 Component 
Description: IBM 2260 Display Station; IBM 2848 Display Control, 
GA27-2700. 



Table 15. IBM 2260 Display Station and 1053 Printer Sense Bits, lOB Flags, and lOB Error Counts 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


















lOBFLl 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

11 Command and 
Data Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL2 




Sense 
Flag 










Film 
Unit 
Flag 
















IOBFL3 












Message 
Type 




Logout 
Flag 














lOB 

Error Counts 

Byte 1 


Bus-Out 
Count 1 


Bus-Out 
Count 2 


Bus-Out 
Count 3 


Error 
Routine 
Channel 
Program 




Channel 

Data 

Check 


Abnormal 
End 

Appendage 
Bit 


Check 




lOB 

Error Counts 

Byte 2 


Interface 

Control 

Check or 

Channel 

Control 

Check 
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Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject This bit is set wtien there is an invaUd modifier bit in a 

commanu, or aii iiivciiiu ^vjiiiiiisnLi sSQuence, i ne error is consivjcrcv^ permanent. 

Bit 1 : Intervention Required 

This bit is set v/hen a Write 1053 Printer comm.and is given but the 1053 Printer 
is not ready. A message is written to the operator. 

Bit 2: Bus-Out Check 

This bit is set when a parity error is detected on a command or data byte during 
bus-out. Processing depends upon when the bus-out check occurred and what 
command was last executed: 

If the bus-out check occurred during initial selection, or during data transmission 
for the 2260 after a Write Line Address or an Erase command, one retry is 
attempted. If the retry is unsuccessful a message is written to the operator. 

If the bus-out check occurred during data transmission for the 2260 after a Write 
Buffer Storage command, one retry is attempted, but before that retry an Erase 
Buffer Storage command is issued. If the retry is unsuccessful, a message is 
written to the operator. 

Bit 3: Equipment Check 

This bit is set when a parity error is detected during a manual read input 
operation. The second load of the 2260 and 1053 Error routine erases the 
message in error and displays an error message on the screen. No automatic retry 
occurs. If a retry is desired, the necessary coding must be included in the user's 
program. (If the error occurs a second time, the user's program should consider it 
permanent.) 

Bits 4-7: Should Not Occur 

If one of these bits is set, a catastrophic error condition is assumed. The logout 
bit in the lOB is set, and a permanent error procedure is performed. 

2301, 2302, 2303, 2305, 2311, 2314, 2321, and 3330 Error Routine 

This routine has several resident versions, one of which is chosen during system 
generation to service the types of devices at an installation. 

This routine attempts recovery from channel data checks. If the Channel Check 
Handler is included with the system, it also examines the error recovery procedure 
interface block to determine whether it should attempt recovery from channel control 
checks and interface control checks. 

Channel programs are usually restarted from the beginning to avoid a repositioning 
problem, command and data chaining problems, and to simplify the handling of errors 
within errors. 

When a track condition check error occurs, the home address record and record are 
read to determine whether the track is defective or is an alternate track. If the track is 
defective, the address of the alternate track is used in a Seek command, and the the 
operation is resumed on the alternate track. If the track condition check occurred on 
an alternate track, the defective track's address, plus 1, is used in a Seek command and 
the operation is resumed on the new track. 
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When a no-record-found error occurs, a console message is not issued if the access 
arm has been positioned at the correct track. A 'permanent error' indicator is set in the 
input/output block. 

When the overflow incomplete bit (sense byte 1, bit 7) is set, only a partial record has 
been read or written, and a CCW is constructed so the remainder of the record can be 
processed. When the overflow incomplete bit is set and the file mask violation, end of 
cylinder, or track condition check bit is also set, the error routine assumes that the first 
record of the continuation track is properly identified as record number 1 . 

This error routine handles cylinder and head switching for both sequential and split 
cylinders. 

When a 2305 or 3330 presents a unit check, lOS performs a sense I/O command for 
24 bytes and then enters the resident direct access ERPs. The ERP then checks the 
error indications in the CSW and sense bits according to the following precedence table 
(Table 17) until a bit is found on. The action referred to will then be performed. 

The control units for the 2305 and 3330 have an error correction capability known as 
the Error Correction Function, or ECF. If a data check occurs in a count or key area, 
the control unit performs ECF internally. If a data check occurs in the data field, the 
sense bytes contain a displacement and a 3-byte correction code for the ERP to use in 
correcting the error. 

The 3330 control unit presents the displacement to the error starting from the 
beginning of the data field, which allows the ERP to apply the correction code when 
data chaining is being performed in the data field. Because the 2305 control unit 
presents the displacement from the last byte transferred, the ERP only corrects the last 
segment if data chaining in the data field is used. If the error is not in the last segment, 
up to ten retries are performed, but the correction code is not applied. 

The ECF supplied by the 3330 and 2305 corrects up to three contiguous bytes of data. 

The error analysis sequence for the IBM 2301 Drum Storage, 2302 Disk Storage, 2303 
Drum Storage, 2311 Disk Storage Drive, and 2314 Direct Access Storage Facility is 
shown in Table 16. Table 17 shows the error analysis sequence for the IBM 2305 
Fixed Head Storage and 3330 Disk Storage. The meanings of sense bits, lOB flags, 
and lOB error counts for all of the direct access devices are given in Table 18. More 
information about the individual devices can be obtained from the following 
publications: 

IBM System/360 Component Descriptions — 2841 and Associated DASD, 
GA26-5988 

IBM System/360 Component Descriptions: 2314 Direct Access Storage 
Facility and 2844 Auxiliary Storage Control, GA26-3599 

IBM System/360 Component Descriptions: 2820 Storage Control and 2301 
Drum Storage, GA22-6895 

IBM System/ 3 60 Component Descriptions: 2835 Storage Control and 2305 
Fixed Head Storage, GA26-1589 

IBM System/360 Component Descriptions: 3830 Storage Control and 3330 
Disk Storage, GA26-1592 
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Table 16. IBM 2301 Drum Storage, 2302 Disk Storage, 2303 Drum Storage, 2311 
Disk Storage Drive, 2314 Direct Access Storage Facility, and 2321 Data 
Cell Error Analysis Sequence (Module IEC23XXF) 





Status 


Sense 






Priority 


Bit 




Byte 


Bit 


Condition 


Pointer 


1 


4b 








Channel Control Check 


ERNT 


2 


46 








Interface Control Check 


ERNT 


3 


44 








Channel Data Check 


ERNT 


4 









3 


Equipnnent Check 


ERNT 


5 






1 


4 


No Record Found 


ERNT 


6 









7 


Seek Check 


ERNT 


7 









1 


Intervention Required 


ERNT 


8 









2 


Bus-Out Check 


ERNT 


9 









4 


Data Check 


ERNT 


10 









5 


Overrun 


ERNT 


11 






1 


6 


Missing Address Markers 


ERNT 


12 












Command Reject 


ERNT 


13 









6 


Track Condition Check 


ERNT 


14 






1 


1 


Track Overrun 


ERNT 


15 






1 


2 


End of Cylinder 


ERNT 


16 






1 


5 


File Protect 


ERNT 


17 


38 








Unit Check 


ERNT 


18 


47 








Chaining Check 


ERNT 


19 


42 








Program Check 


ERNT 


20 


43 








Protection Check 


ERNT 


21 


39 








Unit Exception 


ERNT 


22 


41 








Incorrect Length 


ERNT 


IEC23XXF logs statistics 


in the Systen' 


\ Data Recording work area for all direct-access devices. 


See page 


27 for an 


explanation of the 


pointers. 





Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

When this bit and bit 5 of sense byte 1 (File Protected) are set, the write inhibit 
portion of the file mask has been violated. 

When this bit and bit 3 of byte 1 (InvaUd Command Sequence) are set, one of 
the following has occurred: 

• A Write command was not preceded by the necessary Search or Write 
command. 
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Table 17. IBM 2305 Fixed Head Storage and 3330 Disk Storage Error Analysis 
Sequence (Module IEC23XXF) 





Status 


Sense 






Priority 


Bit 


Byte 


Bit 


Condition 


Pointer 


1 


45 






Channel Control Check 


ERNT 


2 


46 






Interface Control Check 


ERNT 


3 


44 






Channel Data Check 


ERNT 


4 


47 






Chaining Check 


ERNT 


5 




1 





Permanent Error 


ERNT 









3 


Equipment Check 


ERNT 


7 







2 


Bus-Out Check 


ERNT 


8 







1 


Intervention Required 


ERNT 


9 










Command Reject 


ERNT 


10 




1 


4 


No Record Found 


ERNT 


11 







5 


Overrun 


ERNT 


12 




1 


1 


Invalid Track Format 


ERNT 


13 







4 


Data Check 


ERNT 


14 




1 


2 


End of Cylinder 


ERNT 


15 




1 


5 


File Protect 


ERNT 


16 




1 


7 


Overflow 


ERNT 


17 


38 






Unit Check 


ERNT 


18 


42 






Program Check 


ERNT 


19 


43 






Protection Check 


ERNT 


20 


39 






Unit Exception 


ERNT 


21 


41 






Incorrect Length 


ERNT 


IEC23XXF logs statistics 


in the System 


1 Data Recording work area for 


all direct-access devices. 


See page 


27 for an expla 


mation of the 


pointers. 





• A Set File Mask, Reserve, or Release command has been issued in a chain 
where a previous Set File Mask command was given. 

• Head switching is being attempted in a command chain not containing a 
previous seek. 

• Space count has been chained from a Write command. 

• A formatting command is being attempted after record on a defective 
track or following a record which is flagged as an overflow record. 

When this bit and bit 7 of byte (seek check) are set, the 2841 detected an 
invalid seek address or was given a seek address consisting of fewer than six 
bytes. A seek is not initiated. 
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Table 18. IBM 2301 Drum Storage, 2302 Disk Storage, 2303 Drum Storage, 2305 Fixed Head Disk Storage, 
2311 Disk Storage Drive, 2314 Direct Access Storage Facility, 2321 Data Cell (handled by 2321 
error routine), and 3330 Disk Storage Sense Bits, iOB Flags, and lOB Error Counts 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 
2301, 2305, 
3330 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


Data 
Check 


Overrun 




Invalid 
Address 
(2301 
only) 




Sense Byte 
All Except 2301, 
2305, 3330 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


Data 
Check 


Overrun 


Track 

Condition 

Check 


Seek 
Check 


23oT 


Data Check 
in Count 
Area 


Track 
Overrun 


End of 
Cylinder 


Invalid 

Command 

Sequence 


No 

Record 

Found 


File 
Protected 


Service 
Overrun 


Overflow 
Incomplete 


Sense Byte 1 
2305, 3330 


Permanent 
Error 


Invalid 

Track 

Format 


End of 
Cylinder 




No 

Record 

Found 


File 
Protected 


Write 
Inhibit 
(3330 
only) 


Operation 
Incomplete 




Sense Byte 1 
All Except 2301, 
2305, 3330 


Data Check 
in Count 
Area 


Track 
Overrun 


End of 
Cylinder 


Invalid 

Command 

Sequence 


No 

Record 

Found 


File 
Protected 


Missing 
Address 
Marker 


Overflow 
incomplete 




Sense Byte 2 
2305, 3330 


Buffered 
Log Full 
(2305 only) 


Correctable 




Environmental 
Data Present 




















lOBFLl 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and Data 
Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL2 




Sense 
Bit 


Purge 
Flog 


Read 
Home 
Address 
Flag 


No End 

Extent 

Flag 


Track 
Address 
Update 
Flag 










IOBFL3 
2321 


Indicator 1 


Track 

Condition 

Flag 


No 

Record 

Found 


Pick 
Flag 


Restore 
Flag 


Message 
Type 


Sweep 
Flag 


Logout 
Flog 


IOBFL3 

All Except 2321 


Indicator 1 


Track 

Condition 

Flag 


No 

Record 

Found 


Bus-Out 

Error 

Count 


Restore 
Flog 


Message 
Type 




Logout 
Flag 




IOB 

Error Counts 

Byte 1 

2321 


Bits Incremented for: No Record Found, Bus-Out Check, 
Seek Check, Chaining Check, Date Check, Overrun and 
Missing Address Marker 


Bits Incremented for Data Check or Missing 
Address Marker 


IOB 

Error Counts 

Byte 2 

2321 


Incremented for Data Check or Missing Address Marker 


IOB 

Error Counts 
Byte 1 
2301 , 2311 


Data Check Count 


IOB 

Error Counts 
Byte 2 
2301, 2311 


Write 
Indicator 


Overrun Count or Chaining Check Count 


No Record Found, Missing Address Marker, or Seek 
Check Count 



This table applies to all direct access devices, including the 2321 Data Cell Drive, which is handled by the 2321 Error routine 
•This bit may be used to indicate "write Inhibit. " In such a case, the command reject bit (byte 0, bit 0) is also turned on. 
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When the command reject bit is on and the File Protected, InvaHd Command 
Sequence, or Seek Check bits mentioned above are not on, one of the following 
has occurred: 

An invalid command was given. 

An invalid file mask was given. 

The sum of a key length plus data length exceeds 2'^-!. 

An IPL command was given after a Set File Mask command. 

Command out has been presented in response to a request for the first byte 
of a Write Home Address CCW. 

Bit 1 : Intervention Required 

This bit indicates that the device is not physically attached to the system, or is 
physically attached but is not available for use because the file motor is not on, a 
cover is open, etc. 

Bit 2: Bus-Out Check 

This bit is set when a parity error is detected during information transfer from the 
channel to the control unit. The check is an odd parity check which is made on 
control, write, and search operations. (Parity errors which are detected during 
command transfer result in bus-out checks and not command reject.) Ten retries 
are attempted. If the error remains uncorrected, a message is written to the 
operator and the control unit is considered inoperative. 

Bit 3: Equipment Check 

This bit indicates a malfunctioning control unit or device. A message is written to 
the operator. Except for 2305 and 3330, the conditions that cause this bit to be 
set are defined in sense byte 2, bits 0, 2, 4, and 5. 

Bit 4: Data Check 

This bit is set when an error is defected in the information received from the 
device. Data Check will usually occur when an attempt is made to read a record 
which overflows a track. For the 2305 and 3330, if the correctable bit (byte 2, 
bit 1) is on, the Error Correction Function is used. 

Bit 5: Overrun 

This bit is set when a chained CCW is received too late to be properly executed 
or when channel response is too slow during data transfer. Ten retries are 
attempted. If the retries are unsuccessful the error is considered permanent and a 
message is written to the operator. An overrun condition always results in an 
immediate stop of data transmission. For Write operations, the record area is 
padded with zeros. 

Bit 6: Track Condition Check (All except 2301) 

This bit is set when one of the following conditions has occurred: 

• Any single track command other than Search Home Address, Read Home 
Address, or Read Record is executed on a defective track. 

• Any multitrack command other than Search Home Address, Read Home 
Address, or Read Record causes a switch to a defective track, or an 
overflow operation is attempted to a defective track. 
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• Any multitrack command or overflow operation attempts to switch from an 
alternate, or defective track on which a read or search type command has 
been executed. 

Bit 7: Seek Check 

This bit is set when the device is unable to successfully complete a seek because: 

• The seek address is invalid. Command Reject (byte 0, bit 0) is also set. 

• The seek address consists of fewer than six bytes. Command Reject (byte 
0, bit 0) is also set. 



• The last three bytes at the track's home address are not identical to the last 
three bytes of the seek address. 

The meanings of sense bits, lOB flags, and lOB error counts have been combined for 
the 2301, 2302, 2303, 2311, and 2314 and are shown in Table 16. Table 17 shows 
the combination for 2305 and 3330. More information about the IBM 2321 Data Cell 
Drive can be obtained from the following publication: IBM System/360 Component 
Descriptions — 2841 and Associated DASD, GA26-5988. 



2400/3400 Tape Series Error Routine 



The 2400/3400 Tape Series Error routine uses two operations designed to clear or 
circumvent sections of the tape that are presumably contaminated or defective. These 
operations are (1) the tape cleaner action and (2) the erase gap action. 

The tape cleaner action is a "shoe shining" operation in which the tape is run back and 
forth to produce a wiping action both at the read head and at the tape cleaner blade. 
This action transfers contaminants from the read head to the tape and from the tape to 
the cleaner blade. 

If the tape is being read forward, the cleaner action consists of a backward motion 
(toward the supply reel) equal in length to five records, followed by a forward motion 
equal in length to four records, positioning the read/ write head at the beginning of the 
record that was being read when the data check occurred. 

If the tape is being read backward, the cleaner action consists of a backward motion 
equal in length to four records, followed by a forward motion equal in length to five 
records, positioning the read/ write head at the end of the record that was being read 
when the data check occurred. 

The erase gap action is performed whenever a write error is detected. It consists of 
erasing a 3-1/2 inch portion of the tape, starting at the beginning of the write area 
assumed to be defective. This action treats the error as unrecoverable; the gap is a 
detour around the defective area. 

The noise bit (byte 1, bit 0) is set if a data check occurs and: phase encoding (PE) is 
used; or non-return-to-zero-inverted recording (NRZI) is used. If a data check occurs 
and the noise bit is not set, it is assumed that the data check may have been caused by 
too short a record block. In this case, the record length is checked, and if it is less than 
12 bytes, the record block is defined as a "noise block." Noise blocks are skipped and 
treated as permanent errors except when found by an integrated emulator on 7-track 
tapes; then all noise blocks are returned to the emulator for further processing. The 
DEBOFLGS field of the DEB identifies the tape as an emulator tape. 
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The error routines also treat parity errors differently on 7-track tapes being read by an 
integrated emulator. Rather than being a permanent error, the parity is switched 
(DEBVMOD field of the DEB) and the block reread in the alternate parity until 10 
read-recovery sequences have been executed (40 retries) or the read is successful. 
After 10 read-recovery sequences, the parity is switched back to the original parity and 
the block is reread until 10 read-recovery sequences have been executed (a permanent 
error) or the read is successful. 



Table 19. IBM 2400/3400 Series Magnetic Tape Units Error Analysis Sequence (Load 1— IGEOOOOI, Load 
2— IGEOIOOI, Load 3— IGE0200I, Load 4— IGE0300I, Load 5— IGE0400I, or Load 
6— IGE0900I) 





Status 


Sense 




Applicable to: 








Priority 


Bit 


Byte 


Bit 


Condition 


Read 


Write 


Control 


Pointer 


Loadi 


1 


45 






Channel Control Check 


X 


X 


X 


ER2404B 


4 


2 


46 






Interface Control Check 


X 


X 


X 


ER2404B 


4 


3 


38 






Unit Check 


X 


X 


X 


ER2404B 


4 


4 







3 


Equipment Check 


X 


X 


X 


ER2404A 


4 


5 







2 


Bus-Out Check 


X 


X 


X 


ER2404A 


4 


6 







1 


Intervention Required 


X 


X 


X 


ER2404A 


4 


7 










Command Reject 


X 


X 


X 


ER2404A 


4 


8 







5 


Overrun 


X 


X 




ER2404A 


4 


9 




1 


4 


Load Point 


X 


X 




ER2404A 


4 


10 







4 


Data Check 


X 


X 


X 


ER2404A 


4 


11 




7 


4 


Data Security Erase 






X 


ER2402A 


2 


12 


44 






Channel Data Check 


X 


X 


X 


ER2404A 


4 


13 







7 


Data Converter Check 


X 






ER2404A 


4 


14 




1 


7 


Not Capable 


X 






ER2404A 


4 


15 




5 


3 


PE ID Burst Check 




X 


X 


ER2401A 


1 


16 








No Previous Sense Bits 
On 


X 


X 


X 


ER2404A 


4 


17 


47 






Chaining Check 


X 






ER2404B 




18 


42 






Program Check 


X 


X 


X 


ER2404B 


4 


19 


43 






Protection Check 


X 






ER2404B 


4 


20 


41 






Incorrect Length 


X 


X 




ER2404B 


4 



Only errors that occur during Read— opposite recovery are handled by Load 3. 

See page 27 for an explanation of the pointers. 
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TaWp on TR\,4 OAC\Ci /lACiCi Qf^rif^c \Ac 



5„f> TTrsite Qfincfs Rite JCiVi. Flarrc arsH ir^R TTt 





Bit 


Bit 1 


1 

Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


Data 
Check 


Overrun 


Word 
Count 
Zero 


Data 

Converter 

Check 


Sense Byte 1 


Noise 
Bit 


Unit 

Status 

A 


Unit 

Status 

B 


7-Track 

Tape 

Unit 


Tape 
at Load 
Point 


Unit in 

Write 

Status 


File 

Protect 

btatus 


Not 
Capable 


Sense Byte 2 














Multi 
Error 


Track 
Exists 














Sense Byte 3 


Read/Write 
Vertical 
Redundancy 
Check 


Longitudinal 
Redundancy 
Check 


Skew 


Cyclic 

Redundancy 

Check 


Skew 

Register 

Vertical 

Redundancy 

Check 


Phase 
Encoding 


Backward 


C-Compore 


Sense Byte 4 




Reject 

Tape 

Unit 


Read 

Clock 


Write 
Clock 


Delay 
Counter 


C 
Sequence 


B 
Sequence 


A 
Sequence 




lOBFL 1 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 

Control 


Reposition 

Tape 


Cyclic 
Redundancy 
Check 
Bit 


Exceptional 
Condition 




Start 

1 Restart 




IOBFL2 




Sense 
Bit 


Purge 
Flag 




Read/Write 

Unit 

Exception 


Use Read 
Opposite 
Recovery 
CCW from 
lOB 














IOBFL3 


Noise 

Message 

Given 


lOB 

Entry 

Bit 


Tape 

Cleaning 

Bit 


Control 
Flag 


Read 

Opposite 

Recovery 


Message 
Type 


Control 

Unit 

Busy 


Logout 
Flag 


lOB 

Error Counts 

Byte 1 


Interface 
Control 
Check or 
Channel 
Control Check 


Overrun, Bus-Out Check, 
Channel Data Check, 
Chaining Check 




Cleaner Control Count 




lOB 

Error Counts 

Byte 2 


Write 
Indicator 


Read Data Ch 


eck Counts 




User ERG Data Check 


Error Routine 
ERG Data Check 


Write Check Counts 
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When an ending status (channel end, device end, or unit check) appears in the channel 
jstatus word, the 2400/3400 Tape Series Error routine increments the 'block count' 
field of the data control block by the amount shown in the 'block count increment' 
field of the input/output block (lOB). 

If an error remains uncorrected after retry attempts, or if no retries are attempted, a 
message (lEAOOOI) is written to the operator. For all error conditions except 
'command reject, load point, data converter check' and 'not capable,' the logout flag of 
the lOB is set before entry to the I/O supervisor's Write-to-Operator routine. This is 
an indication to the I/O supervisor's Write-to-Operator routine to invoke the 
Outboard Recorder after it writes the message. 

I The error analysis sequence for the IBM 2400/3400 Series Magnetic Tape Units is 
shown in Table 18. The meanings of the sense bits, lOB flags, and lOB error counts 
are shown in Table 19. More information about IBM 2400/3400 Series Magnetic 
Tape Units can be obtained from the following publications: 

• IBM System/360 Component Description: 2400 Series Magnetic Tape Units, 
2803/2804 Tape Controls, and 2816 Switching Unit, Model 1, GA22-6866 

• IBM System/360 Component Description: 3803/3420 Magnetic Tape 
Subsystems, G A3 2-0020 

Sense Byte Meanings and Actions Taken 

Byte Bit 0: Command Reject 

This bit is set when a command is received which the device has not been 
designed to execute. The error is considered permanent. 

Byte Bit 1 : Intervention Required 

This bit indicates a not-ready condition. Actions taken depend upon whether a 
device end status was also received: 

With no device end, unit status B (sense byte 1, bit 2) is examined. If 0, 
the device is assumed not to exist and the error is considered permanent. If 
unit status B is 1 , a message is given the operator. When he readies the 
device, the operation is attempted again. 

With device end, if a Rewind Unload command was the last command 
executed, a successful completion is assumed and processing continues. 
Otherwise, the condition is ignored and the scan of sense bits is continued. 

Byte Bit 2: Bus-Out Check 

This bit is set when even parity appears on the information bus lines from the 
channel to the control unit. The command is attempted again. The tape is first 
repositioned if the bus-out check occurred during a write operation. 

Byte Bit 3: Equipment Check 

This bit is set when a unit fails to respond to a set read or a set write status when 
instructed, or becomes not ready during execution of a tape motion operation. 
The error is considered permanent. 

Byte Bit 4: Data Check 
I During a read or read backward operation: If the noise bit (byte 1, bit 0) is off 

and the blocksize is less than 12 bytes, the noise block flag in the statistics 

I update mask is set and regular operation is resumed with the next block (except 

when 7-track tapes are being read by an integrated emulator, in which case the 
noise block is passed back to the emulator). 
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If the noise bit is off, but the blocksize is 12 bytes or greater, or if noise bit is on, 
a read recovery sequence is initiated. This sequence consists of the following 
steps! 

1. Reposition the tape. 

2. Issue the Track-in-Error command to send error information (byte 2, bit 7) 
to the tape control unit. 

3. Re-read the tape. If error persists, post (or repost) the applicable flag bit 
(representing a temporary 'read' error) in temporary storage. 

4. Repeat steps one through three for a total of four rereads unless a good read 
is obtained. 

5. Perform a tape cleaner action and increment the temporary cleaner action 
counter in the Volume Statistics Table. 

A total of ten read recovery sequences can be initiated. If the error is not cleared 
by that time, a read-opposite recovery sequence is initiated, provided that none of 
the following conditions exists: 

• Data ciiaming is uemg performed. 

• Data conversion mode and 7-track tape are being used. 

• The original CCW count is less than the physical block size on the tape. 

• "Suppress data transfer" is specified in the original CCW. 

During a write or write tape mark operation: reposition the tape, issue an erase 
gap, issue a mode set (if 7-track), and reissue the command. 

3400 write: repeat this procedure until successful or until 14 retries have 
been attempted. If the error persists after 14 retries, go to step 1 below. 

2400 write: (2400/3420 write tapemark) repeat this procedure until 
successful or until 15 retries have been attempted. If the error persists after 
15 retries, go to step 2 below. 

Step 1. Change the failing write CCW to a "loop-write-to-read" CCW. The 
write CCW must not be command or data chained from or to any of the CCWs 
in the original failing CCW chain. After the loop-write-to-read has been 
completed, the failing write CCW is issued to complete the fifteenth retry. 

Step 2. Provide an operator message, post completed with error condition, and 
exit to operating system. 

During an ERG: reissue the command. Repeat this procedure until 3 retries have 
been attempted. If the error persists, provide an operator message, post 
completed with error condition, and exit to the operating system. 

Byte Bit 5: Overrun 

This bit is set when service is requested but data cannot be transferred during a 
read, write, or read backward operation. Five retries are attempted. Before each 
retry, the tape is repositioned. Note: A data check during overrun suppresses the 
overrun indication. 
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Byte Bit 6: Word Count Zero 

This bit is set during a write operation if transfer of data is prevented before the 
first byte is written. This indicator is ignored. 

Byte Bit 7: Data Converter Check 

This bit is set when an error occurs during operation of the data conversion 
feature. The error is considered permanent. 

Other Actions Taken 

Byte 1 Bit 7: Not Capable 

Set on some models when density handling features are not compatible with 
actual tape density. No retries are attempted. 

Byte 5 Bit 3: Phase Encoding ID Burst Check 

Reposition to load point with a Rewind command and reissue the command. 
Repeat this procedure until successful, or until 14 retries have been attempted. 
A Loop-write-to-read command is issued and the fifteenth write retry is issued. 

Byte 7 Bit 4: Data Security Erase Error 

Print a message to the operator and record as a permanent error. 

Unexpected Device End 

Print a message to the operator and reissue the command. 

Channel Data Check 

This status bit is set when a channel detects a parity error in the information 
transferred to or from main storage during an I/O operation. Five retries are 
attempted. The tape is repositioned before each retry of a read or write 
operation. 

Chaining Check 

This status bit is set when channel overrun occurs during data chaining on read 
operations. Five retries are attempted. The tape is repositioned before each 
retry. 

Interface Control Check 

Channel Control Check 

An interface control check is caused by an invalid signal on the I/O interface; 
channel control check is caused by any machine malfunction affecting channel 
controls. The 2400/3400 Series Magnetic Tape Error routine receives control 
only if the Channel Check Handler is in the system. Actions taken by the 
2400/3400 Series Magnetic Tape Error routine are shown below. Error recovery 
procedure interface bytes (ERPIB) are supplied by the Channel Check Handler 
routine. The 2400 Channel Check ERP passes control to the 3400 Series 
Channel Check routine if the device is one of the IBM 3400 series. 

No retries are attempted when: 

• ERPIB byte 4, bit 7 is on (unconditional no-retry). 

• ERPIB byte 6, bit 3 or 4 or 5 is off (retry code invalid, unit status invalid, 
or command address invalid). 

• ERPIB are not produced. 

• ERPIB byte 7, bits and 1 are both on (system reset). 

• ERPIB ,byte 4, bit 2 is on (Test I/O with no pending interruption stored a 
CSW). 
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ERPIB byte 4, bit 3 is on (Halt I/O stored a CSW). 

ERPTB byte 4, bits and 1 are both on or both off. 

ERPIB byte 4, bit 5 is off (if unit check). 

There is a unit check and an equipment check. 

The interface control check or channel control check occurred during tape 
repositioning (unless cc=l). 

Retries are attempted when none of the above conditions exists and ERPIB 
termination codes and retry combinations are: 

• Termination code 10, retry code 010. Write command — retry once. 

• Termination code 01, retry code Oil or 101. Write or Read 
command — reposition and retry once. For other commands (except Set, 
Mode, and Transfer-in-Channel) the operation is considered complete and 
no recovery is attempted. 

If the device is one of the 3400 series, retries are attempted when any of the following 
conditions exist: 

Read or Read Backward, termination code of 00, 01, or 10, and sequence 
code 001. 

Write, termination code 00, 01, or 10, and sequence code 001. 

Control (Read/Write), termination code 00, 01, or 10, and sequence code 
001. 

Control (Rewind/Unload/Mode Set), termination code 00, 01, or 10, and 
sequence code 001 or 010. 

Sense, termination code 00 or 01, and sequence code 001, 010, Oil, or 101. 

For all other termination and sequence code combinations, the errors are not 

4._:„ui« 

icuiauic. 



2495 Error Routine 



The 2495 Error routine attempts recovery from channel data checks. When the 
Channel Check Handler is included with a system, the 2495 Error routine also 
examines the error recovery procedure interface block to determine whether it should 
attempt recovery from channel control checks and interface control checks. 

The error analysis sequence for the IBM 2495 Tape Cartridge Reader is shown in 
Table 21. The meanings of sense bits, lOB flags, and lOB error counts are shown in 
Table 22. 

More information about the IBM 2495 Tape Cartridge Reader can be obtained from 
the following publication: IBM System/ 360 Component Description, IBM 2495 
Tape Cartridge Reader, G All -21 26 
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Table 21. IBM 2495 Tape Cartridge Reader Error Analysis Sequence (Module 
IGEOOllA) 



Status 



Sense 



Priority 


Bit 


Byte 


Bit 


Condition 


Pointer 


1 


45 






Channel Control Check 


ERR033 


2 


46 






Interface Control Check 


ERR033 


3 


44 






Channel Data Check 


ERR033 


4 


42 






Program Check 


ERR033 


5 


43 






Protection Check 


ERR033 


6 


38 






Unit Check 


ERR033 


7 







5 


Should Not Occur 


ERR046 


7 







7 


Should Not Occur 


ERR046 


8 







3 


Equipment Check 


ERR046 


9 







2 


Bus-Out Check 


ERR046 


10 







1 


Intervention Required 


ERR046 


11 







6 


Position Check 


ERR046 


12 







4 


Data Check 


ERR046 


13 










Command Reject 


ERR046 


14 








None of the Above Sense Bits On 


ERR046 


None 


39 






Unit Exception 


ERR033 


None 


41 






Incorrect Length 


ERR033 


See page 


27 for an 


explanation of the 


pointers. 





IBM 2495 Tape Cartridge Reader Sense Byte Meanings 

Bit 0: Command Reject 
This bit is set when: 

• An invalid command is received and the control unit is not busy. 

• A Read command is received after end-of-tape has been sensed and blank 
tape is encountered. 

• A Control Rewind or Control Backspace command is received when the 
tape is in the load position. 

• A Control Backspace command is received immediately following a position 
check caused by another Control Backspace command. 

No retries are attempted. 
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Table 22. IBM 2495 Taoe Cartridse Reader Sense Bits. lOB Flaes, and lOB Error Counts 





BitO 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
ivequired 


Bus-Out 

Check 


Equipment 
Check 


Data 




Position 
Check 








lOBFL 1 


00 No Chaining 

01 Command Chaining 
10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 


Unrelated 
Flag 


Start 

1 Restart 






iOBFL2 




Sense 
Bit 


Purge 
Flag 
























IOBFL3 




iOB 

Entry 

Flag 


Read 
Channel 
Data Check 

Count 


Bus-Out 
Error Count 




Message 
Type 




Logout 
Flag 








lOB 

Error Counts 

Byte 1 


Read Position 
Check Count 


Read Data 

Check Count 



Bit 1 : Intervention Required 

This bit is set when a comniand is received and the control unit is in the 
not-ready state because: 

The stop key was depressed. 

The hopper is empty and the end-of-file key has not been depressed. 

The power is off. 

The stacker is full. 

An auto-loader malfunction occurred. 

The requestor's RQE is queued so that when the tape drive is made ready the 
command will be reissued. 

Bit 2: Bus-Out Check 

This bit is set when a command with even parity appears on a bus-out operation. 
If the bit is set during initial selection, the operation is retried once. On the 
second occurrence, the error is considered permanent. 
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2540 Error Routine 



Bit 3: Equipment Check 
This bit is set when: 

• The leader is disconnected. 

• The tape is jammed. 

• The tape is not repositioned. 

• A motion detection device fails. 

The error is considered permanent. 

Bit 4: Data Check 

This bit is set when a byte with even parity is detected in the data register during 
a Read command. The tape is backspaced one byte and the remaining portion is 
read. The sequence is repeated up to ten times. The UCB extension is used as a 
work area for constructing a backspace CCW, a residual read CCW, and, for 
command chaining, a transfer-in-channel to the next user CCW. If the error 
remains after ten retries, it is considered permanent. 

Bit 5: Should Not Occur 

When this bit is set, a catastrophic error is assumed. 

Bit 6: Position Check (Read Command) 

This bit is set when a Read command causes the reading of tape past the stop 
code, beyond the end of valid data. The stop code was not detected or was 
ignored by the program. The tape is backspaced one byte and the data is reread. 
The sequence is repeated up to ten times. If the error remains, it is considered 
permanent. The UCB extension is used as a work area for constructing a 
backspace CCW, a residual read CCW, and, for command chaining, a 
transfer-in-channel to the next user CCW. 

Bit 6: Position Check (Control) 

This bit is set by indicate that a Control Backspace command has caused 
backspacing to the beginning of the tape. No retries are attempted. 

Bit 7: Should Not Occur 

When this bit is set, a catastrophic error is assumed. 



The 2540 Error routine attempts recovery from channel data checks. Read operations 
are retried five times; punch operations are retried once, if a bus-out check resulted 
from the channel data check. When the Channel Check Handler is included with a 
system, the 2540 Error routine also examines the error recovery procedure interface 
block to determine whether it should attempt recovery from channel control checks and 
interface control checks. 

The error analysis sequence for the IBM 2540 Card Read Punch is shown in Table 23. 
The meanings of sense bits, lOB flags, and lOB error counts are shown in Table 24. 
More information about the IBM 2540 Card Read Punch can be obtained from the 
following publications: 

• IBM System/360 Component Description and Operating Procedures: IBM 
2540 Card Read Punch, GA2 1-9033 

IBM 2821 Control Unit, GA24-3312 
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Table 23. IBM 2540 Card Read Punch Error Analysis Sequence (Load 1-IGEOOOlC or Load 
2-IGEOlOlC) 



Priority 


Status 
Bit 


Sense 
Byte Bit 


Condition 


Applicable to: 
Read Punch Control 


Pointer 


Load 


1 


45 






Channel Control Check 


X 


X 


X 


ERR551 




1 


46 






Interface Control Check 


X 


X 


X 


ERR551 




2 


47 






Chaining Check 


X 


X 


X 


ERR546 




3 


44 






Channel Data Check 


X 






ERR524 




4 


38 






Unit Check 


X 


X 


X 


ERR525 




5 







5 


Should Not Occur 


X 


X 


X 


ERR546 




5 







7 


Should Not Occur 


X 


X 


X 


ERR546 




6 







3 


Equipment Check 


X 


X 




ERR528 




7 







1 


Intervention Required 


X 


X 




ERR552 


2 


8 







2 


Bus-Out Check 


X 


X 




ERR534 


2 


9 







4 


Data Check 


X 






ERR536 


2 


10 










Command Reject 


X 


X 


X 


ERR548 


2 


11 







6 


Unusual Command 
Sequence 


X 






ERR555 


2 


12 


42 






Program Check 


X 


X 


X 


ERR543 


2 


13 


43 






Protection Check 


X 


X 


X 


ERR543 


2 


14 


39 






Unit Exception 


X 






ERR543 


2 


15 


41 






Incorrect Length 


X 


X 




ERR543 


2 


See page 


27 for an expU 


ination of the po 


nters. 













Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

The setting of this bit indicates one of the following: 

• A Read Backward or a Write command was issued to the reader. 

• A Read Backward control other than NOP or a Read Feed and Stacker 
Select command was issued to a punch without the Punch Feed Read 
feature. 

• A Read Backward or Control command was issued to a punch with the 
Punch Feed Read feature. 

• An incorrect sequence of instructions was issued. 

• An invalid command was received. 
The error is considered permanent. 

Bit 1 : Intervention Required 

The setting of this bit indicates a not-ready condition due to one of the following 

• Cards are not at each station (not end-of-file for the reader). 

• The stacker is full. 

• The hopper is empty (not end-of-file for the reader). 
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• The Stop key was depressed. 

• The chipbox is full or has been removed. 

• There is a card jam. 

A message is given the operator, who must take action. Upon correction of the 
condition, the interrupted operation is repeated. 

Bit 2: Bus-Out Check 

This bit is set when a parity error has occurred on bus-out on a command or data 
byte (bus-out is a data transfer from the processing unit to the control unit). 
When this error is detected, no punching occurs. The operation is retried once 
and if the error occurs a second time it is considered to be permanent. 

Bit 3: Equipment Check 

This bit is set after one of the following: 

• A hole count error 

• A buffer parity error 

• A translate check 

• An address check 



Table 24. IBM 2540 Card Read Punch Sense Bits, lOB Flags, and lOB Error Counts 





BitO 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense 


Command 
Reject 


Intervention 
Required 


Bus- Out 
Check 


Equipment 
Check 


Data 
Check 




Unusual 

Command 

Sequence 








lOBFL 1 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL2 
















QSAM 
Access 
Method 
















IOBFL3 


Indicator 1 


Entry 
Flag 


Read 
Error 
Count 


Bus- Out 

Error 

Count 


Punch 
Relay 


Message 
Type 


QSAM 
Count 


Logout 
Flag 


Error Counts 
lOBECT 
Byte 2 


Accept 
Unusual 
Command 
Sequence 








Data Check, Channel Data 


Channel Con- 
trol Check, 
Interface 
Control Check 








Checl< ' ' '■ ■ 
Count 


, equipment (_he 


ck 
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The error applies to the card that preceded the one from which data was 
transmitted; it is considered permanent. If the error occurred during the 
processing of a Read comrnanu, tue operation is retricQ iivc limes. Ii me error 
occurred during a QSAM operation, one retry is attempted. 

Bit 4: Data Check 

This bit is set when an invaUd card code is detected. The operation is retried five 
times. On the sixth occurrence, it is denoted as a permanent error. 

Bit 5: Should Not Occur 

Bit 6: Unusual Command Sequence 

This bit is set when there are two consecutive reads without an intervening feed. 
The error is considered permanent. 

Bit 7: Should Not Occur 



Table 25. IBM 2671 Paper Tape Reader Error Analysis Sequence (Module IGE00021) 





Status 


Sense 






Priority 


Bit 


Byte 


Bit 


Condition 


Pointer 


1 


45 






Channel Control Check 


ERZERIB 


1 


46 






Interface Control Check 


ERZERIB 


2 


47 






Chaining Check 


ERR611 


3 


38 






Unit Check 


ERR601 


4 







5 


Should Not Occur 


ERR611 


5 







6 


Should Not Occur 


ERR611 


6 







7 


Should Not Occur 


ERR611 


7 







3 


Equipment Check 


ERR611 


8 







1 


Intervention Required 


ERR608 


9 







2 


Bus-Out Check 


ERR609 


1 








4 


Data Check 


ERR611 


11 










Command Reject 


ERR612 


12 


44 






Channel Data Check 


ERR625 


13 


42 






Program Check 


ERR618 


14 


43 






Protection Check 


ERR618 


15 


39 






Unit Exception 


ERR619 


16 


41 






Incorrect Length 


ERR619 



See page 27 for an explanation of the pointers. 



The eighth character in the module name is not printable, but can be represented by X'CO' 
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2671 Error Routine 



The 267 1 Error routine treats all channel errors as permanent. Because the IBM 267 1 
Paper Tape Reader cannot be backspaced or repositioned under program control, all 
unit check errors except a bus-out check are considered permanent. The bus-out 
check is retried once and if not corrected, is considered permanent. 

The error analysis sequence for the IBM 267 1 Paper Tape Reader is shown in Table 
25. The meanings of the sense bits, lOB flags, and lOB error counts are shown in 
Table 26. More information about the IBM 2671 Paper Tape Reader can be obtained 
from the following publication: IBM 2671 Paper Tape Reader; IBM 2822 Paper 
Tape Reader Control, GA24-3388 



Table 26. IBM 2671 Paper Tape Reader Sense Bits, lOB Flags, and lOB Error Counts 





BitO 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


Data 
Check 












lOBFL 1 


00 No Chaining 

01 Command Chaining 
10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL3 




Equipment 


Bus- Out 

Error 

Count 




Message 
Type 




Logout 
Flag 




Check 


^ount 







Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set when a Read Backward or a Write command is received at the tape 
reader, or when valid commands have invaUd modifier bits. A parity error on the 
command prevents this condition from being detected. This bit also indicates a 
permanent error. 

Bit 1 : Intervention Required 

This bit is set when the device is "not ready." A Paper Tape Reader becomes 
ready when: 

• Power is on. 

• The tape is loaded. 

• The Start key is pressed. 
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3211 Error Routine 



The Paper Tape Reader becomes not ready immediately when: 

• The Stop key is pressed while no read operation is in progress. 

• The Load key is pressed. 

The Power-On and Reset keys are pressed. 
The Paper Tape Reader becomes not ready after a read operation when: 

• There is an overstep condition (the tape did not stop on one character). 

• Tape jams in the take-up stacker. 

• The end of the tape is detected at the reading station but the end-of-file 
light is off. 

• The Stop key has been depressed during the read operation. 

When the device is made ready, a device end interruption occurs. 

Bit 2: Bus-Out Check 

This bit is set when a parity error is detected on a command byte. One retry is 
attempted. 

Bit 3: Equipment Check 

This bit indicates that a timeout has been detected in the tape reader since the 
last data byte was sensed at the tape read station. This timeout of approximately 
one second can be caused by: 

A photocell failure 

A tape drive motor failure 

An unusual tape creeping condition 

A length of unpunched tape 

Tape jamming in the optional stackers 

A light projection system failure 

A permanent error 

Bit 4: Data Check 

This bit is set when an invalid character is read; it indicates a permanent error. 

Bits 5-7: Should Not Occur 

If any of these bits are set, a catastrophic error is assumed. The logout flag is set 
in the JOB, a permanent error is signaled to the error EXCP routine, and control 
is returned via SVC 15. 



The 3211 Error routine attempts recovery from channel data checks only if they occur 
with bus-out checks. A channel data check occurring alone is not considered an error. 

When the Channel Check Handler is included with a system, the 3211 Error routine 
also attempts recovery from channel control checks and interface control checks. 



Section 2: Method of Operation 67 



PageofGY28-6616-9 
Revised April 30, 1973 
By TNL GN26-8036 



In addition to handling the normal functions of an error recovery procedure, the 3211 
ERP compiles data for device dependent OBR records. These records are then 
recorded on SYSl.LOGREC by the recording module IGE0625F. The following 
information will be recorded: 

1. FCB Parity Check — Carriage Control Address Register (CCAR) and 
the FCBID in the UCB 

2. PLB Parity Check — Diagnostic Check Read Data and the first 10 
positions of the PLB 

3. UCS Parity Check— Contents of UCS buffer and the UCSID in the UCB 

The error recovery procedure for the 3211 Printer is shown in Table 27. The meanings 
of sense bits, lOB flags and lOB error counts are shown in Table 28. 

More information can be obtained from the following publication: IBM 3211 Printer 
and 3811 Control Unit Component Description, GA24-3543. 



I Table 27. IBM 321 1 Printer Error Analysis Sequence (Module IGEOOOOF) 





Status 


Sense 






iority 


Bit 


Byte 


Bit 


Condition 


Pointer 


1 


45 






Channel Control Check 


ERR031 


1 


46 






Interface Control Check 


ERR031 


2 


47 






Chaining Check 


ERR070 


3 


38 






Unit Check 


ERR040 


4 




1 


5 


Command Suppress 


ERR050A 


5 







3 


Equipment Check 


ERR051 


6 







2 


Bus-Out Check 


ERR052 


7 







4 


Data Check 


ERR055E 


8 







5 


Buffer Parity Check 


ERR053 


9 










Command Reject 


ERR071 


10 







6 


Load Check 


ERR070 


11 







1 


Intervention Required 


ERR055 


12 







7 


Channel 9 


ERR064A 


13 


44 






Channel Data Check 


ERR061 


14 


42 






Program Check 


ERR062 


15 


43 






Protection Check 


ERR062 


16 


41 






Incorrect Length 


ERR063 


17 


39 






Unit Exception 


ERR064 



See page 27 for an explanation of pointers. 
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I Tabic 28. IBM 321 1 Printer Sense Bits, !OB Fla"s and lOB Ei 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Comrrmnd 
Reject 


Intervention 
Required 


Bus-Out 
Check 


Equipment 
Check 


Data 
Check 


Buffer 
Parity 
Error 


Load Check 


Channel 9 


Sense Byte 1 


Command 
Retry 


Print 
Check 


Print 
Quality 


Line 
Position 


Forms 
Check 


Command 
Suppress 


Mechanical 
Motion 






Sense Byte 2 


Carriage 
Fail to 


Carriage 
Sequence 


Carriage 
Stop 


Platen 
Fail to 


Platen 
Fail to 


Forms 
Jam 


Ribbon 
Motion 


Train 
Overload 


Sense Byte 3 


UCSB 
Parity 


PLB 

Parity 


FCB 

Parity 


Coil 
Protect 


Hammer 

Fire 

Check 


Field 
Engineering 


UCSAR 
Sync 

Check 


Sep Sync 
Check 


lOBFLl 


00 - No Chaining 

01 - Command Chaining 

10 - Data Chaining 

1 1 - Both 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




- Start 

1 - Restart 








IOBFL3 


MCS 
Flag 


Entry 
Flag 


Command 
Suppress 
Error 
Count 


Bus-Out 

Error 

Count 


Buffer 
Flag 


Message 
Type 


TPER 
Flag 


Logout 
Flag 


lOBECT 


FCB 
Count 








FCB 
Count 


UCS 
Count 


Channel 

Error 

Count 












IOBECT+1 












MCS 
Count 


MCS 

Count 


MCS 

Count 













Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set during Initial Selection when a command other than those defined 
for the printer is given. The error is considered permanent. 

Bit 1: Intervention Required 

This bit indicates a not-ready condition due to one of the following: 

Platen failure 

Ribbon motion or ribbon skew 

Jammed or torn forms 

Carriage Stop-Release Off 

Interlock condition 

An Intervention Required message is issued for the operator; when the condition 
is corrected the last operation is repeated. If this occurs with channel 9 (bit 7) 
the message is given to the operator, but the error is handled as a channel 9 
condition. The operator has the option of forcing a permanent error by pressing 
the Cancel button on the 3211. 
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Bit 2: Bus-Out Check 

This results when the control unit receives a data byte or a command byte with 
invalid parity. The operation is retried once in a non-multiple console support 
system and 5 times in an MCS system. 

Bit 3: Equipment Check 

This bit indicates a malfunction that affects the operation in process. The specific 
condition will be indicated by a bit in byte 1 . 

Bit 4: Data Check 

This bit signifies that there is an incomparable code in the UCSB or in the FCB. 
An Intervention Required message will be written to the operator and when the 
condition is corrected the previous operation will be retried. The operator will 
have the option of causing a permanent error by pressing the Cancel button on 
the 3211. 

Bit 5: Buffer Parity Check 

This bit indicates invalid parity in the UCSB or FCB. The error is considered 
permanent. 

Bit 6: Load Check 

This bit is given for a load UCSB or load FCB command when the load was 
invalid. The error is considered permanent. 

Bit 7: A channel 9 code was sensed in the FCB during a carriage motion. 

Sense Byte 1 Meanings 

Bit 0: Command Retry — This indicates a parity error in the print line buffer. The 

error is considered permanent. In a system with MCS the error is retried 5 times 
before it is considered permanent. 

Bit 1 : Print Check — Indicates the line in process may contain one or more print errors. 

Bit 2: Print Quality — Indicates a machine failure that could affect print quahty. 

Bit 3: Line Position — Indicates that the previous line or next line to be printed may be 
in the wrong place. 

The last three conditions will result in an Intervention Required message to the 
operator. When the condition is corrected the last operation is repeated. The operator 
will have the option to cause a permanent error by pressing the Cancel button on the 
3211. 

Bit 6: Mechanical Motion — Signifies that the command in process cannot be 

completed and the results are unpredictable due to hardware failure. The error is 
considered permanent. 

If bit 3 of byte is set and no bits in byte 1 are set, a sync check or train overload 
exists. These errors are considered permanent. 



3505/3525 Error Routine 



The 3505/3525 Error routine attempts recovery from I/O errors that cause an 
interruption. The condition causing the interruption is indicated in the channel status 
word (CSW). If the unit check (bit 38) is present in the CSW, a sense command is 
performed to obtain further information about the error interrupt. The status byte and 
sense byte provide information and reasons for a unit check detected in the last 
operation. Sense byte 1 defines the ERP actions required for the unit check. 
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The error analysis sequence for the IBM 3505 Card Reader and the IBM 3525 Card 
Punch with Read and Print feature is shown in Table 29. The meanings of the sense 
bits, lOB flags, and lOB error counts are shown in Table 30. More information about 
the IBM 3505/3525 can be obtained from IBM 3505 Card Read and IBM 3525 
Card Punch Subsystem, GA21-9124. 



Table 29. IBM 3505/3525 Error Analysis Sequence (Module IGEOOOIA) 



Priority 


Status 
Bit 


Sense 
Byte Bit 


Condition 


Applicable to: 

Read Punch Printer Control 


Pointer 


1 








Channel Control Check 


X 


V 


X 


X 


ER.R001 


2 


46 






Interface Control Check 


X 


X 


X 


X 


ERR011 


3 


44 






Channel Data Check 




X 


X 


X 


ERR012 


4 


32 






Should Not Occur 


X 


X 


X 


X 


EXIT12 


5 


33 






Should Not Occur 


X 


X 


X 


X 


EXIT12 


6 


34 






Should Not Occur 


X 


X 


X 


X 


EXIT12 


7 


38 






Unit Check 


X 


X 


X 


X 


SENSEO 


8 







5 


Should Not Occur 


X 


X 


X 


X 


EXIT12 


9 







7 


Permanent Error (Key) 


X 


X 


X 


X 


EXIT22 


10 







3 


Equipment Check 


X 


X 


X 




ERR002 


11 







6 


Abnormal Format Reset 


X 








SENSE1 


12 







1 


Intervention Required 


X 


X 


X 


X 


ERR003 


13 







2 


Bus-Out Check 


X 


X 


X 


X 


SENSE1 


14 







4 


Data Check 


X 








SENSE1 


15 










Command Reject 


X 


X 


X 


X 


SENSE1 


16 


47 






Chaining Check 


X 








EXIT12 


17 


42 






Program Check 


X 


X 


X 




ERR004 


18 


43 






Protection Check 


X 


X 


X 


X 


ERR004 


19 


39 






Unit Exception 


X 








ERR004 


20 


41 






Incorrect Length 


X 


X 






ERR004 


See page 


27 for an explanation of the pointers. 













Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set on for invalid commands such as read backwards and for commands 
for uninstalled features. The error is considered a permanent condition. 

Bit 1 : Intervention Required 

This bit is set on for a hopper misfeed, hopper jam, cornering station misfeed. 
Read station check, transport jam, and normal user occurrences such as hopper 
empty, joggler open, stacker full, stop key depressed, or covers open. 

Recovery from this error is possible as defined by recovery indicators on the 
machine. 
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Table 30. IBM 3505/3525 Sense Bits, lOB Flags, and lOB Error Counts 





Bit 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bi* 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reiect 


Intervention 
Required 


Bus- Out 
Cl^eck 


Equipment 
Check 


Data 

Check 




Abnormal 

Format 

Reset 


Permanent 

Error 

Key 




lOBFL 1 


00 No Chaining 

01 Command Chaining 
10 Data Chaining 

1 1 Command and 
Data Chaining 


Error 

in 
Control 






Evceptional 
Condition 




Start 

1 Restart 








lOBFL 2 
















QSAM 
Access 
Method 
















IOBFL3 


Auto. 
Retry 
Flag 
Command 


Entry 
Flag 


Channel 
Control 

Check 


Interface 

Control 

Check 


Punch 
Retry 


Message 
Type 


QSAM 
Count 


Logout 
Flag 


Error Counts 
lOBECT 
Byte 2 












Channel Con- 
trol Check, 
Interface 
Control Check 









Bit 2: Bus-Out Check 

This results in a bad parity on bus-out during initial selection. The error is 
considered a permanent condition only after the second try. 

Bit 3: Equipment Check 

This bit is turned on for errors due to data compare check, emitter check, and CU 
internal parity check detected between IS and CE. 

A recovery can be made as defined by the recovery indicators on the machine. 

Bit 4: Data Check 

This results when an invaUd EBCDIC card code is found when Data Mode 1 is 
read. Recovery can be made as defined by recovery indicators on the machine. 

Bit 5: Not Used 

Bit 6: Abnormal Format Reset 

Bit 7: Permanent Error (Error Bypass Key) 

This results when the operator presses the Error Bypass Key rather than 
performing recovery assistance. The error is considered a permanent condition. 
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Sense Byte 1 Meanings 

Bit 0: Permanent Error 

This bit directs the ERP to post a permanent error condition and proceed with 
appropriate disposition of the condition. It is set only with sense byte 0, bit or 
bit 1. 



Bit 1 : Automatic Retry 



life try fott-Trinrr tVio -foilinrr C^C^WI /^t-ir»o Tf 

Ai.l'O XJ.X XWI.I. VXXX^ l.XX^/ X L4.XXXXX^ \^ X_^ ▼▼ V^XX^W • XX 



:.f.i1 n 



1 r*r/^m-ot 



execution continues. If unsuccessful, a permanent error condition is posted and 
the procedure is continued with the appropriate disposition of the condition. This 
occurs only with sense byte 0, bits 2 and 3. 

Bit 2: Motion Malfunction 

This bit is turned on with Intervention Required when the cause is other than a 
normal user occurrence. It is set only with sense byte 0, bit 1. This bit is not 
required by the ERP to effect recovery but is included to facilitate the 
measurement of SSIs. 

Bit 3: Retry After Intervention Required Complete 

After a normal not-ready to ready Device End, the faiUng CCW is reissued. This 
occurs only with sense byte 0, bits 1, 3, 4, and 6. 

Bits 4-7: Not Used. 

Sense Byte 2 Meanii^s 

This sense byte is for diagnostic purposes only. It defines the first error in the 3505 or 
3525 and also serves as a pointer to the appropriate maintenance documentation. 

Sense Byte 3 Meanings 

This sense byte is for diagnostic purposes only. It serves to further resolve a limited 
group of errors. 

Channel Checks 

Recovery from channel errors (channel control check, interface control check, and 
channel data check) is as follows: 

If Selective Reset or Interface Disconnect was given between Initial Selection and 
Channel End, reissue the command to the 3505 or 3525. 



5450 Error Routine 



The 5450 Error routine attempts recovery from channel data checks. When the 
Channel Check Handler is included with a system, the 5450 Error routine also 
examines the error recovery procedure interface block to determine whether it should 
attempt recovery from channel control checks and interface control checks. 

The error analysis sequence for the 5450 Integrated Console for Model 85 is shown in 
Table 31. The meanings of sense bits, lOB flags, and lOB error counts are shown in 
Table 32. 
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Table 31. IBM 5450 Integrated Console for Model 85 Error Analysis Sequence 
(Module IGEOOIOD) 





Status 


Sense 






Priority 




Byte 


Bit 


Condition 


Pointer 


1 


45 






Channel Control Check 


ERR450 


2 


46 






Interface Control Check 


ERR450 


3 


44 






Channel Data Check 


ERR450 


4 


38 






Unit Check 


ERR600 


5 







1 


Should Not Occur 


ERR600 


5 







5 


Should Not Occur 


ERR600 


6 







2 


Bus-Out Check 


ERR600 


7 







4 


Data Check 


ERR605 


8 







7 


Buffer Address Parity Check 


ERR600 


9 







6 


Invalid Buffer Address 


ERR600 


10 










Command Reject 


ERR600 


11 







3 


Equipment Check 


ERR600 


12 


42 






Program Check 


ERR618 


13 


43 






Protection Check 


ERR618 


14 


39 






Unit Exception 


ERR618 


15 


41 






Incorrect Length 


ERR618 


See page 


27 for an 


explanation of the 


pointers. 





Sense Byte Meanings and Actions Taken 

Bit 0: Command Reject 

This bit is set when there is an invalid modifier bit in a command, or an invalid 
command sequence. One retry is attempted. If the retry is unsuccessful, the 
error is considered permanent. 

Bit 1 : Should Not Occur 

When this bit is set, a catastrophic error is assumed. 

Bit 2: Bus-Out Check 

This bit is set when a parity error is detected on a command or data byte during 
bus-out. One retry is attempted. If the retry is unsuccessful, the error is 
considered permanent. 

Bit 3: Equipment Check 

This bit is set when an error is detected during a keyboard operation. The error 
is considered permanent. 

Bit 4: Data Check 

This bit is set when a buffer parity error is detected. One retry is attempted. If 
the retry is unsuccessful, the error is considered permanent. 
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Table 32. IBM 5450 Intesrated Console for Model 85 Sense Bits. lOB Flass. and lOB Error Counts 





BitO 


Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 


Bit 6 


Bit 7 


Sense Byte 


Command 
Reject 




Bus-Out 
Check 


Equipment 
Check 


Data 
Check 




Invalid 

Buffer 

Address 


Buffer 
Address 
Paritv 
Check 






iOBFL 1 


00 No Chaining 

01 Command Chaining 

10 Data Chaining 

1 1 Command and Data 
Chaining 


Error 
Routine 
in 
Control 






Exceptional 
Condition 




Start 

1 Restart 








IOBFL2 




Sense 
Flag 


Purge 
Flag 






















IOBFL 3 


Command 

Reject 

Retry 


Bus-Out 

Error 

Retry 


Equipment 

Check 

Retry 


Data 

Check 

Retry 


Buffer 

Address 

Parity 

Check 

Retry 


Invalid 
Buffer 
Address 
Retry 




Logout 
Flag 





Bit 5: Should Not Occur 

When this bit is set, a catastrophic error is assumed. 

Bit 6: Invalid Buffer Address 

This bit is set upon detection of a buffer or cursor address having vaUd parity but 
lying outside of the valid buffer xy address range. One retry is attempted. If the 
retry is unsuccessful, the error is considered permanent. 

Bit 7; Buffer Address Farity Check 

This bit is set when there is a parity error on a buffer or cursor address. One 
retry is attempted. If the retry is unsuccessful, the error is considered permanent. 



Writing Error Recovery Messages to the Operator 



When an error is uncorrectable or when a condition exists that could be changed by 
operator action, an I/O error routine invokes the I/O supervisor's Write-to-Operator 
routine, which composes a message to be written on the console output device 
(Diagram 12). The Write-to-Operator routine handles three messages: Uncorrectable 
Input/Output Error (lEAOOOI), Inoperative Path (lEAOOlI), and Intervention Required 
(lEAOOOA). It uses a Write-to-Operator macro instruction to cause them to be 
written on the' console output device. 

The I/O supervisor Write-to-Operator routine is contained in five modules. The first 
(IGE0025C) determines which modules to invoke and produces the Intervention 
Required message. The second (IGE0125C) determines which message is to be written 
and invokes either the third (IGE0225C) or fifth (IGE0425C) load to produce the 
Uncorrectable Input/Output Error message. Load four (IGE0325C) produces Start 
I/O condition code 3 error messages. The full text of each message is in the "I/O 
Supervisor Messages" part of Section 7. 
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Recording Error Data 



Two types of data are produced to document I/O device failures: error statistics and 
environmental data. Error statistics are counts of the number of times errors have 
occurred on individual I/O devices. Environmental data documents the time and 
circumstances of the errors. Both types of data are recorded in the SYSl.LOGREC 
data set, where they can be retrieved in an edited format by means of the IFCEREPO 
Utility program, described in the publication OS Utilities, GC28-6586. Operations 
discussed in the following text are: 

Recording outboard records 

Recording inboard records 

Recording miscellaneous data records 

Interfacing with IFBSTAT (SVC 76) 

Writing environment recording error messages to the operator 

The routines involved in the above operations are shown in Figure 1 1 . 



Recording Outboard Records 



Overflow Recording 



The Outboard Recording routine (OBR) is called through a special XCTL entry. The 
OBR XCTL load name is 025F. The XCTL routine loads the requested segment of 
the Outboard Recording routine into the error transient area. The address of the 
request element (RQE) is passed in register 1 . 

Upon completion of its assigned functions, OBR issues SVC 15 to free the request 
element and returns control the the supervisor via SVC 3. When an EOD command is 
entered for terminals using TCAM, OBR passes control to the error recovery procedure 
until all internal counters are recorded, before returning control to the supervisor. 

As indicated in Figure 1 1 , the Outboard Recording routine receives control for one of 
the following operations: 

• Overflow recording — A statistics table entry has reached maximum value. 

• Permanent error recording — A permanent I/O device failure has occurred. 

• TCAM statistics recording — One of TCAM's two counters has reached its 
maximum value, a terminal error has occurred, or an End-of-Day (EOD) 
command has been entered. 



Counts of the number of times I/O devices have failed are not maintained directly on 
the SYSLLOGREC data set. Instead, intermediate counters are used. The 
intermediate counters are contained in a main-storage table called the device statistics 
table. There is one entry in the device statistics table for every I/O device. 
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(Optional) 



Post Start I/O 


Channel Error 




IGFCAT 




Buffer Full 
(2305, 3211 
3330) 

/2715 
/ Error 


/ 


IGE0625F 






Routine 

I/O Interruption 


Channel Check 

Handler 

(see Appendix C) 


Miscellaneous 
Data Routine 
(generates T-iype 
error environment 
records for 2305, 
2715, 3211, 3330) 






Supervisor 
Sense Subroutine 
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erflow, EOD, termin 

Permanent Error 
or Overflow 


jI error (TCAM) 






















Ov 










/' 










1 
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1-r 


IFBSTAT(SVC76) 
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records on 
5Y51.LOGREC 

• Formats and Records 
EOD records 

• Is'^ijes error messages 
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I/O Interruption 
Supervisor 
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Routine 
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ment at time of I/O 
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Error 






















Corrected 












Error 
EXCP 










Routine 


EOD command 
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Master 




Scheduler 































Figure 1 1 . Recording Error Data 



When an I/O error routine finds that a unit check condition has occurred, it stores the 
sense bit settings it obtains in the device statistics table entry for the faiUng device. 
After it has corrected the error or has found the error to be uncorrectable, the I/O 
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error routine invokes the Statistics Update routine "'hich ex 

settings and increments the appropriate counters in the device statistics table. 

When any counter in the device statistics table reaches it maximum value of 1 5 the 
Statistics Update routine invokes the Outboard Recording routine (OBR). The 
Outboard Recording routine must first determine what type of record it is to prepare: 

Short OBR record— Temporary failure statistics (bit 5 of UCBFL5 field in UCB 
is set to 0). Refer to Figure 39 for the format of a Short OBR record. 

• Long OBR record — Temporary failure statistics (bit 5 of UCBFL5 field in UCB 
is set to 1). Refer to Figure 38 for the format of a Long OBR record. 

When the Outboard Recording routine has prepared the appropriate record, it issues 
SVC 76 to write the record on the SYSLLOGREC data set. 



Permanent Error Recording 



Every time there is a permanent I/O device failure, environmental data is collected, 
placed into a record called an outboard record, and written onto the SYSLLOGREC 
data set. For permanent errors, the Statistics Update routine gives control to the 
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Outboard Recording routine after error counters have been updated. The Outboard 
Recording routine collects the data it needs, creates a long OBR record (see Figure 
38), and issues SVC 76 to write the record on the SYSl.LOGREC data set. 



TCAM Statistics Recording 



For each terminal in a system, TCAM provides two 2-byte counters. The first counter 
keeps track of the number of SIO commands issued to the terminal. The second 
counter provides a count of all failure incidents at the terminal in one byte, and a count 
of selective failure incidents in the other. Both counters are updated by the terminal 
error recovery procedure and are reset to zero after they have been recorded by the 
Outboard Recording routine. 

There are three types of recordings: 

• Normal: Error information, including the contents of the two counters, is 
recorded for all non-correctable incidents. The long OBR record (see Figure 38) 
is used. 

• Intensive: All error incidents are recorded whether or not they are correctable. 
Intensive mode operation must be specifically requested for a particular terminal 
through the operator's console. An additional facility of the selective intensive 
mode enables records to be created when specific errors occur. For example, a 
record can be created each time a data check occurs on a particular terminal. 

• Counter Overflow/End-of-Day: When either of the two previously described 
counters is about to overflow, or when there is an End-of-Day request, a Long 
OBR record is prepared and written on the SYSl.LOGREC data set. (Since 
information such as first or failing CCW, CSW, and sense information is not 
meaningful in this situation, it is not recorded.) 

Record Inboard Records 

On systems with a Channel Check Handler routine, inboard records are created for 
channel failures. The creation of these records takes place before error recovery 
routines are entered. The Outboard Recording routine writes the inboard records 
created by the Channel Check Handler onto the SYSLLOGREC data set via SVC 76. 

The Channel Check Handler requires input describing when and under what conditions 
the channel failure occurred. Therefore, there is a complex interface between the 
Channel Check Handler and other I/O supervisor routines. The interface is shown in 
Diagram 15. 

Detailed information on the Channel Check Handler is contained in Appendix C. 

Recording Miscellaneous Data Records 

The Miscellaneous Data Recording routine collects and formats buffered data stored by 
device dependent error recovery procedures for IBM Models 2305, 3211, and 3330. 

The location of the buffered data depends on the type of device, so the Miscellaneous 
Data Recorder must first check the UCB to determine the device type. It then 
calculates an offset from the UCB to locate the buffer. 

Once it has located the buffer, the routine generates a Miscellaneous Data Record (see 
Figure 40). The record is then written on the SYSl.LOGREC data set via SVC 76. 
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The Miscellaneous Data Recording routine also formats and records IBM Model 27 1 5 
error data that is not stored in a buffer. 



ine jviisceiianeous uaia K.ecoruing rouiine receives control irom a uevice uepenuenL 
error recovery procedure via an XCTL macro instruction. The address of the request 
element (RQE) is register 1. 

Upon completion of its assigned functions, the routine checks a return indicator which 
it extracted from the third and fourth bytes of the buffer or from the 2715 interface. 
If the indicator contains a nonzero value, the address of the RQE is place in reigster 1 
and control is passed to a special XCTL interface location. From there, control is 
returned to the caller. If the indicator equals 0, the routine issues SVC 15 to free the 



;up 
Using the IFBSTAT Interface (SVC 76) 



Both the Outboard Recording routine and the Miscellaneous Data Recording routine 
pass the following information to the IFBSTAT routine: 

• Address of the record in register 1 

• Twos complement of the record length in register 

When IFBSTAT receives control, it checks the contents of register 0. If the value is 
negative, it performs a recording function. If the value is positive, an EOD 
(End-of-Day) record is to be formatted and written on the SYSl.LOGREC data set. 
Further information on SVC 76 is contained in Appendix A. 



Writing Environment Recording Error Messages to the Operator 



When an I/O error occurs during activity on the SYSl.LOGREC data set, when the 
SYSl.LOGREC data set is almost full, or when there is not enough room on the 
SYSl.LOGREC data set for another record, the fourth load module of IFBSTAT (SVC 
76) is invoked to write a message to the operator (Diagram 15). 



Operation Diagrams 



This section contains diagrams that illustrate how the I/O supervisor performs I/O 
operations, with particular emphasis on where it obtains data and how it acts upon that 
data. 

In the program Ustings, the symboUc names which are shown in individual data area 
fields are equated to the offset, in bytes, from the beginning of a table to the field. 
Access is gained to a specific field by using an instruction in which the beginning 
address of the table (usually contained in a register) is the base address, and the 
symboUc field name represents the displacement. 

There are places where the symbolic field names will differ from names used in other 
pubUcations. Names used here were taken from I/O supervisor Ustings and, where 
differences exist, a non-I/O supervisor program may refer to the field by the other 
name. (To resolve name differences, compare offsets; if the offsets match, the names 
represent the same field.) 

Usage of the data area fields can be traced in the I/O supervisor Ustings by first 
locating the symbolic field names in the cross-reference table at the back of the Ustings 
and then noting where the names are used. 
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System Generafic 




1 




16- Byte 
Request 
Elements 




are described in the publication 

OS System Generation, GC28-6554. 






I 



Diagram 1. Creating a Request Queue Element 
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• Chart AB, Get Request Element Rout! 
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System Generotic 




Unit Control 
Blocks I— I 



The system generation macro instructions ore 
described in the publication OS 
System Generotion, GC28-655i 




Unit Control Block 
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Appropriate 
Enqueuing Routine 



^ 
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that precedes Diagram 1 In this section. 
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Diagram 2. Queuing a Request Queue Element 
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The request element is now 
in a logical channel queue. 
The ones in its link field 
indicate it is the lost request 
element in the queue. For 
other requests for activity 
on devices on the same 
logical channel, the request 
element will be queued as follows; 



O^ 



FIFO: 



Priority: 



The unit control block, device 
table and logical channel table 
ore described under Data Area 
Layouts in Section 5. 

For additional intormation, see: 

• Chart AB, Get Request Element Routine 

The functions siiown in ttiis diagram are 
preformed by the Enqueue routines, which 
are not detailed in flowcharts. They can 
be found in the listings at the label XCPPNQ. 



The RQE will be added 
to the queue following 
the lost-queued element. 

The RQE will be odded to 
the queue in order of 
priority. The priority used 
is that in the TSTPR 
field of the RQE. 

: The RQE will be 
added to the queue 
in order of seek address 
for non-related requests. 
The seek address used 
comes from the extent 
field (lOBDAM) of the 
lOB. 
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^ 
^ 
O 
^ 
^ 
^ 
« 



Diagram 3. Testing Channel Availability 
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Channel 
Address 



TCH (UAREG) Channel Availabl 



^ 



UAREG 





Channel 

AdHre55 


Unit 
AHHreu 



a 



& 









The values used for channel 
addresses and the numbers 
used in the symbolic names 
of the Test Channel routine 
entry points ore not fixed. 

Th^y mny vnry het-eeP 

installations. 



If the channel is available, 
the address of the device 
is placed into UAREG in 
preparation for the Start I/O 
instruction. 



I ut-PKtti I 



5 (5) UCBUA 



The Test Channel instruction 

is not executed when the 

channel being considered is 

a multiplexor channel. Byte multiplexor 

channels are assumed to be available. 

When a channel is found to be unavailable and there 
are no alterrwte paths, the request element 
is queued 

When a channel is found to be unavailable but 
or>e or more alternate paths exist, 
additional attempts ore mode on the alterrxite 
chanrwis. If oil of the alternate 
channels ore found to be unavailable, 
the request element is queued- 



The symbolic names used for data area fields 
in this diagram may not agree with names used 
in other publications. See the explarKition that 
precedes Diagram 1 in this section. 



For additional information, see: 

• Chart AC, Test Channel Routines. 
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Address of First CCW 
to be Executed 



b 



1 lOBREG 


H 














Input/Output Block 




Command 
Code 













v^ 



0111 0000 



Normal Start and Restart Operati< 



Address of First CCW 
to be Executed 



Input/Output Block 








Address of 
Normal Start 
CCW 






Address 
of Restart 
CCW 




|25 (19) I0BRST| 









c 



Requestor's CCW 




The symbolic names used for data area fields in thi: 
diagram may not agree with names used in other 
publications. See the explanation that precedes 
Diagram 1 in this section. 



Diagram 4. Starting Unit-Record, Communications, and Graphics Devices 
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For additional informatio 



I Chart AD, Start I/O Routine for 
Unit Record and Communications 



I Chart AK, Start I/O Subroutine. 
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Unit Control Block 
|48 (30) UCBRORJ-- 



Address of 
Opposite \,y 
Direction 
Recovery 
CCW 



The symbolic names used for data area fields 
in this diogrom rrray not agree with names 
used in other publications. See the explana- 
tion that precedes Diogrom 1 in this section. 



Diagram 5. Starting Magnetic-Tape Devices: Normal Start, Restart, and Opposite Direction 
Recovery Operations 
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o 



0110 0000 


^ 


I 




For additional information, see; 

• Chart AE, Start I/O Routine for 
Magnetic Tape Devices. 

• Chart AK, Start I/O Subroutine. 
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\ 



Unit Control Block 
|24 (18) UCBSN5 +2\ 



) 



Input/Output Block 
117(11) IOB5T \- 



|25 (19) lOBRST | ---.,_ 



Command 
Code 



r 



J 



Address of Contn 
InformaHon 



Address of Requestor' s 
First CCW 



\ 



Unit Control Block 














^ 
^ 



The symbolic names used for data area fields 
in this diagram may not agree with names used 
in other publications. See the explanation 
that precedes Diagram 1 in this section. 



For odditionol information, see: 



• Chart AE, Start I/O Routine for 
Mognetic Tape Devices. 



• Chart AK, Start I/O Subroutines. 



Diagram 6. Starting Magnetic-Tape Devices After a Cyclic Redundancy Check Condition 
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0110 0000 


^ 


1 



a 



A CRCBTE 





Control 
Information 


1 



O^ 




5IO 0,UAREG 
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Chonnel 
Address 


Unit 
Address 



Sysfem Generall 




One Entry in 
Channel Table 
for Each Channel 
in the System 



One Channel Search 
Routine-CCW Camb- 
ination for Each 
Channel in the System 



Channel 
Table 




Channel Address, 
when Multiplied by 
4, Yields the 
Offset in Bytes 
to the Appropriote 
Entry in the 
Chann*l Table 



Channel Table: Contains 



one entry for every 
channel in the system. 
Each Entry is 4 bytes 
long. The beginning of 
the table is indicated 
by the symbolic name 
lECCST. 



' Note: If the system hos the shored DASD option, 
a RESERVE command is issued with every stand 
alone seek. This is done to prevent the second 
CPU from moving the access orm of the device 
during the data transfer chonnel program. 
However, if the RESERVE field in the UCB is 
zeros, the RELEASE command is choined to the 
channel program to free the device for use by 
the second CPU after the stand alone seek. 







ECCST 










Channel Entry 






Channel 1 Entry 






Channel 2 Entry 






Address of 
Channel Search Rtn 






* 








Channel 4 Entry 




Channel 5 Entry 




Channel 6 Entry 





Set File Mask CCW 



Each Channel 
Table Entry 
Contains the 
Address of a 
Channel 
Search Routine 





Transfer in Channel CCW 








Channel Search 
Routine 







Cha 



el Seofch RoutJr 



The 



is one Channel Search routine 
for every channel in the system. 
Every Channel Search routine 
for a channel containing a direct 
access device is preceded by three 
CCWs. The address of the first of 
these Is obtained by subtrocting 
24 from the address of the Channel 
Search routine. 



For additional information, see 

• Charts AF, AG and AH, Start I/O 
Routine for Direct Access Devices. 

• Chart AK, Start I/O Subroutine. 



The symbolic names used for data area fields 
in this diagram may not agree with names used 
in other publications. See the explanation that 
precedes Diagram 1 in this section. 



K 



Unit Control Block 



48 (30) UCBSKA 
(g)BBCCHHR 



^ 



Pointer to 
Track Address 



Placed into 
■ Seek CCW 
(See Above) 



Diagram 7. Starting Direct- Access Devices 
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Seek 


Pointer to Track Address 



01 100000 


^^ 


6 



OIIOOOOO 


File Mask 


I 




<H 



Extent Mask, when 
Multiplied by 16, 
Yields the Offset, 
in Bytes, to the 
Extent Field in 
the Appropriate 
DEB. 



1 DEBREG |-^ 


\ 


Data Extent Block 


-1 32 (20) DEBMDM |. 
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I Prot.j 
^Key j 



uption Code^^^ 



7 8 11 12 15 16 





ts 32 34 36 39 40 



Start I/O Instruction, Resulting 
Condition Codes: 

I/O Operation Initiated and 
Channel Proceeding with its 
Execution. 



< 1 



CSW Stored. 
Channel or Subch< 
Not Operational 



If necessary, remove the 
requestor's RQE from the 
logical channel queue. 




Notify operator. Try alternate 
paths. Place RQE into logical 
channel queue. 



For additional information, see: 

• Chart AK, Start I/O Subroutine. 

• Chart AL, Post Start I/O Routine. 



The flow of control during analysis of 
CSW status bits is shown in Chart Al, 
Post Stort I/O Routine. 



Diagram 8. Checking Condition Codes 
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Channel Status Word 
CSWLOC 



Prot. 
Key 




pAddressof LastCCW+8 ^ S=-^^-4-¥^ 


3 4 7 8 


31 


Status 


^^H^S 




Attention 
Status Modifier 
Control Unit End 
Busy 

Channel End 
Device End 
Unit Check 
Unit Exception 

Program-Controlled Interruptic 
Incorrect Length 
Program Check 
Protection Check 
Channel Data Check 
Channel Control Check 
Interface Control Check 
Chaining Check 




S^ 



Retry the operation when the status bits 
show that: 



There was a pending control unit 
end interruption. (Control unit 



Give control to the I/O Interruption 
supervisor when the status bits show 
that: 

• An immediate operation has 
just been completed. (Busy off 
and bits 44, 45, and 46 off.) 



ontrol to a system environment 

which requires further analysis. 
(Busy off and channel data check 
or channel control check or 
Interface control check on.) 



here was a pending attenti 
nterruption. (Busy on and 
levice end on and attentior 









Retry the operation using another path 




when the status bits show that: 




• The control unit is busy. (Busy 




on and status modifier on.) 



^ 






Place the requestor's RQE into a logical 




channel queue when the status bits 




show that: 




• The I/O device is busy. 


\ 


(Busy on.) 



ijive control to the Attention Kout 
Interface and then retry the I/O 
operation when the status bits show 
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SiO 0,UAREG 



I/O Operation ^ 
Initiated O 



s 



when the 


I'O 


Interrupt 


on 


Occurs, 


Statu 


Informat' 


on Is 


Placed ir 


to 


the C5W 


by 


the Chan 








When the I/O Inter- 
ruption Occurs, 
the Contents of 
the Current 
PSW are Stored 
in the I/O Old 
PSV/ Location 



^ ; 0000 ; ^ jAddressof Lost CCW+8 fA 

Key , ; ►; rf , A ■. 



lits 3 4 7 . 



" ' Count" "Vs 



32 Attention 

33 Status Modifier 

34 Control Unit End 

35 Busy 

36 Channel End 

37 Device End 

38 Unit Check 

39 Unit Exception 

40 Program-Controlled Interruptit 

41 Incorrect Length 

42 Program Check 

43 Protection Check 

44 Channel Data Check 

45 Channel Control Check 

46 Interface Control Check 

47 Chaining Check 




When the Unit Check 
Status Indicator is 
On, a Sense Command 
is Used to Obtain 
Additional Information 
About the Cause of the 
Unit Check Condition, 




Following I/O Interruptions, 
the Interruption Code 

Field of the I/O old PSW 

^^^ Contains the Channel 
and Device Address of 
the Interruption-Causing 
Device. 



>0 



Bits 32 34 36 39 40 



For additional information, see: 



The symbolic names used for data area fis 
In this diagram may not agree v/ith names 
in other publications. See the explonotif 
that precedes Diagram I in this section. 



I Charts BA to BE, I/O Interruption 
Supervisor. 



. Charts BG and BH, Sense Subroutin 



Diagram 9. Checking Status Indicators (Part 1 of 2) 
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Address ot 
Sense CCW 



Prot. 
Key 



. iYibtlNbt 



Address of First CCW 
to be Executed 



Address of Sense Dota 
Field (UCBSiNS) in uC3 



OOiOOOOO V/////A 

x/z/z/zx 



when the device on which 
a seek is being performed 
is a shared direct-access 
device, a Reod Home Address 
commond and a Read Record 
command ore also executed. 
The information in these two 
records is made avoiloble 
to error routines. 




Unit Control Block 


[ 22 (16) UCBSNS | 


,k 







Up to 6 Bytes of 
Sense Data are 
Placed into the UCB 



Control 
Unit 



o 



System 
Mask 


Prot. 
Key 


AMWP 


Channel 
Address 


Device 
Address 



T 





lECILKl 




, 


J 

D 






<^ 






IECILK2 


d 




UCB Lookup 
Table 







UCB 1 


The I/O Interruption 
Supervisor uses the 


- 




UCB 1 


UCB Lookup Table 
to Determine which 
UCB Represents 




UCB 1 


the Request for 
Which the I/O 
Interruption 




UCB 1 


Occurred. 






UCB 1 
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Channel Status Word 
C5WLOC 



I Prot 



0000 



Address of Last CCW+8 



lits 3 4 7 8 





" " / " " 




Status 




, '' Count 




tUt-t, 





C:=^m 



Bit 32 Attention 

33 Status Modifier 

34 Control Unit End 

35 Busy 

36 Channel End 

37 Device End 

38 Unit Check 

39 Unit Exception 

Bit 40 Program-Controlled interruptic 

41 Incorrect Length 

42 Program Check 

43 Protection Check 

44 Channel Data Check 

45 Channel Control Check 

46 Interface Control Check 

47 Chaining Check 



Channel End Signals 
the Completion of 
the Data Transfer 
Part of an I/O 
Operation. 



Bytes 1-7 of the 
CSV/ ore Placed 
into the Requestor'! 
lOB 



« 






The Requestor': 
RQE Is Re- 
turned to the 
Freelist. 



^ 



The symbolic names used for data area fields 
in this diagram may not agree with names used 
in other publications. See the explanation 
that precedes Diagram 1 in this section. 



For additional information, see: 



. Charts BB and BC, I/O lnterrupti< 
Supervisor 



Diagram 9. Checking Status Indicators (Part 2 of 2) 
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>'^'«^^=immmmmim«.«^!m.>isim 



Ihe tvenf \_om 
pletion Code 
is Placed into 
the Requestor's 
ECB 



Input/Output Block 



0(0) 



4(4) 
(lOBCOl 



J 



(') 



2(2) 



5(5) 



lOBCSW* 



♦Offset Is 8; lOBCSW is equated to IOBFL3 



16(10) 

lOBCC 



20(14) 
Reserved 



24(18) 
lOBMDB 



17(11) 



lOBST 



25 (19) 



lOBRST 



32 (20) 

lOBDAM 



30 (IE) 



33(23) 



^!.v.'.».■.•.J•^;•:•^;.l•^:■H•^»v 



(0) ECBFL 



H 



Bytes 1-3 are Set 
to Zeros. 



• rnntr^l RU^U 



Request Queue 



^ 



:::t:ia:::S:-SS8g:¥Sg;a^gSai«W?gaa:a^taiSS:S8Sg8 




■^jmrn^is^m^ 
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LCHREG 



Logical Channel 
Word Table 





0(0) TSTLNK 
] 1 



















The symboiic r>ames used for data area fields 
in this diagram may not agree with names used 
In other publicotions. See the explanation 



in other publicotiui 
that precedes Diagi 



1 in this secti( 



Diagram 10. Starting Scheduled I/O Operations 
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Acidresses of Control 
Blocks are Placed intc 
General Registers. 
Thus, on Environment 
Identical to That 
Which Existed When 
the Request was First 
Processed is 
Recreated 



For additional information, see; 

• Chart BD, I/O Interruption Supervisor. 



• Chart BM, Channel Search 
Routine, No Alternate Paths. 



I Chart BN, Channel Search 
Routine, Alternate Paths. 



. Charts BO and BP, Channel Search 
Routine, Multiplexor Channel. 




Another Attempt is Mode 
to Start the I/O Activity. 
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Ch. 



I Status Wofd 
CSWLOC 



Trotl 
Key 


P^ 


1 


^^^^^H 


BSM^M 


i 



Status 


^5^^ Count^ 


^^g 


^^^^ 




32 Attention 

33 Status Modifier 

34 Control Unit End 

35 Busy 

36 Channel End 

37 Device End 

38 Unit Check 

39 Unit Exception 



\^ 



40 Program-Controlled InterrupHon 

41 Incorrect Length 

42 Program Check 

43 Protection Check 

44 Channel Data Check 

45 Channel Control Check 

46 Interface Control Check 

47 Chaining Check 





Zeros in the Fifth 
and Sixth Bit Po- 
sitions of this Field 
Indicate that an I/O 
Supervisor Error 
Routine is to be 
used. 



Diagram 1 1 . Invoking Error Routines (Part 1 of 2) 
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Unit Control Block 



The symbolic names used for data 
this diagram may not agree with 
other publications. See the explanat 
precedes Diagram 1 in this section. 



For additional information, see: 

• Chart BF, Error Routine Interface. 

• Chart CB, I/O Error Recovery Rout 



Request Queue Element 
TSTUCB+ 1 3(3) 



j^ The Supervisor': 

BCR 15, WKREGl > ^'°9* ^ ^"'^ 

— 1/ Effector Routine 

is Invoked. 



The Low Order Bit 
of the RQE's 
'UCB Address' 
Field is Set to One. 
The Supervisor's 
Stage 2 Exit Ef- 
fector Routine will 




A Resident Error 
Routine is Entered 
Via a Branch 
Instruction. 
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This Diagram shows, in general, what supervisor 
routines do to schedule transient I/O error routin< 
It does not show all functions performed by superv 
routines, nor does It show all of the supervisor 
routines involved. For additional information, sei 



o 



OS MVT Supervisor Log! 

GY28-6659. 

OS MFT Supervisor Logit 

GY27-7236. 



The Supervisor' s Stage 2 
Exit Effector Routine Adds 
the Request Queue Element 
(ROE) to One of its Asyn- 
chronous Exit Queues. 



Asynchronous Exit 
Queue 



i<^ ^:^ ^^^ - .^ : ir:: a^' ;SE ^^ 



When the System Error 
TCB Becomes the Controllini 
TCB, the Stage 3 Exit 
Effector Routine is Invoked 
Once Again. This Time, 
its Function is to Locate 
the I/O Error Routine. 



When a Copy of the 
I/O Error Routine Must 
be Obtained, the Super- 
visor's Program Fetch 
Routine is Used. 




The Supervisor's Progror 
Fetch Routine Uses the 
EXCP Macro Instructior 
Making the I/O Super- 
visor, in Effect, the 
Requestor of its Own 
Services. 



If a Copy of the Needed 
I/O Error Routine Al- 
ready Exists in the T'O 
Supervisor Transient Area 
the Stage 3 Exit Effector 
Causes it to be Invoked. 



Diagram 11. Invoking Error Routines (Part 2 of 2) 
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The Supervisor' s Stooe 3 Exit 
Effector Routine Queues One 
RQE at a Time to a System Inter- 

r.jption Ronno.t Rlnrt (SIRB). 

It then Places a Pointer to the 
SIRB into a Special High- 
Priority System Error Task Con- 
trol Block (TCB) to Complete 
the Scheduling of the Error 
Routine. 













Program Fetch Work Area 








Input/Output 
Block 




Event Control 
Block 




Channel 
Program 


















I/O Supervisor Transient Area 



The input/output block (lOB), event control block (ECB 
and the channel program used in obtaining the 
I/O error routine are contained in a 68-byte 
program fetch work area which immediately precedes 
the I/O supervisor transient area. 
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when a mi 
recovery i 
block and 



^ssage is to be written to the operator, ti^e error 
outine sets a message type flag in the input/output 
invokes the Write-to-Operotor routine. 



J-^ 



Input/Output 



\jOBFL3ya^ il 



1 (1) 



lOBECB 



T^A ""'i'i"'!"v ■•'■'■ 



lOBCSW* 
*Offset !s 8; lOBCSW is equaled to IOBFL3 



16(10) 
lOBCC, 



20 (14)- 



17(11) 



21(15) 



25 (19) 



32 (20) 
lOBDAM 



vVhen the Start I/O 
Instruction was Executed 
the Resulting Condition 
Code was Saved in the 
lOBCC Field of the 
Requestor' s Input/ 
Output Block 









^ 




OBCCiffl 


k * *'°' 






Mm 





lits 12 3 4 5 6 7 



it 5 of the IOBFL3 field 
s the message type bit. 



^ 



Start I/O Instruction, Resulting 
Condition Codes: 

I/O Operation Initiated and 
Channel Preceding with its 
Execution. 

1 CSW Stored. 

2 Channel or Subchannel Busy 

3 Not Operational 



K 



lO 



Unit Control Block 
UCBCHM 12 (C) 

m 



Diagram 12. Writing Error Recovery Messages to the Operator 
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If the Message Typ6 Bit 
has been Set to 1, the 
Uncorrectable Input/ 
Output Error Message 
is to be Written. 

If the Message Type 
Bit has been Set to 
0, the Message to 
be written is Either 
Intervention Required 
or Inoperative Path. 




Uncorrectable Input/Output Error Message (lEAOOOl) 

Inoperative Path Message (,ea001I) ZI^^ ^^ MF={E,(1) } 



Intervention Required Message 



A Write-to-Operator 
Macro Instruction ir 
used to write the 
message. 



''^J^JZ...^'A<. &..^.- : 



The Low-Order Four 

Bits of the Unit 

Control Blocl<' s UCBCHM 

Field Indicate Which 

Paths to a Device 

are Unavailable (0) and 

Which are Available (1) 



^ 



The Inoperative Path Message is 
Written when the Resulting Con- 
dition Code for the Start I/O 
Instnirtinn is .1 find the field ct 
offset UCBCHM of the UCB for 
the Device- Shows on Unavailable 
Path. Otherwise, the !r!teryen- 
tion Required Message is Written. 




The complete text of each 
message is contained In the 
publication OS Messages 
and Codes, GC28-6631. 



The symbolic names used for data area fie 
in this diagram may not agree with names 
in other publications. See the explonatlo 
that precedes Diagram I in this section. 
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Unit Control Block 



When on I/O Error 
Routine Finds a Unit 
Check Condition, it 
Must Indicate to the 
Statistics Update Routii 
What Sense Bits ore 
On, so that Error 
Counters Could Later 
be Updated. 




0(0) 



4(4) 
UCBCHA 



12(C) 
UCBCHM 



10) 
UCBALLC 



5(5) 
UCBUA 



9(9) 
UCBSTI 



2(2) 
UCBID 



6(6) 
UCBFLI 



10(A) 
UCBLCI 



3(3) 
SRTESTAT 



7(7) 
UCBDTI 



11(B) 
UCBATI 



13(D) 



16(10) 



20(14) UCBLTS 



n 



22(16) UCBSNS 
Sense Information 



24(18) 



Additional Sense lnformati( 



The I/O Error Routine Obtains 
the Sense Data from the Foiling 
Device's Unit Control Block, and 
Builds in a Two-Byte Work Area 
A Pattern in Which Eoch Bit 
Represents a Status for which 
Stotistics ore Kept. 



The symbolic names used for data area fields 
in this diagram may not agree with names used 
in other publications. See the explanation 
that precedes Diagram 1 in this section. 




The I/O Error Routine Places the 
Sense Pattern it has Built into 
the Last Two Bytes of the Statistics 
Table Entry for the Failing Device. 

For Each Retry, the I/O Error 
Routine Alters the Sense Pattern 
in the Statistics Table Enh-y 
to Include Status Conditions Which 
were Not Encountered During 
Previous Retries. Thus, the occurrence 
of all Errors, Both During the 
Initial Attempt and All Retries, 
is Recorded. 



Diagram 13. Updating the Device Statistics Table (except for 2305 and 3330) 
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r 



Dev- 


ce Statistics Table 


Control Field 


Enfr" ! 


Entr/ 2 


Entry 3 


Entry 4 



An I/O Error Routine Invokes 
the Statistics Update Routine 
After it Corrects an Error or 
When it Finds an Error to be 
Uncorrectable. 



The Statistics Update Routine 
Increments the Four-Bit 
Counters in the Failing Device's 
Statistics Table Entry According 
to the 'On' or 'Off Setting of the 
Bits Stored in the Last Two 
Bytes of the Entry. 



Statistics Table Entry for Failing Device 





it i Bit Bit i Bit Bit j Bit Bit . Bit Bit ; Bit Bit , Bit Bit , Bit Sense Sense 

1:2 3i5 6;7 0;I 2;3 4;5 6;7 Pattern Pattern 



Device Statistics Table Entry for o Failing Devic 



















00100000 01100000 




Note : in the sense pattern 
one bit is set for each 
type of error, regardless 
of how many times the 
error recurs during retries 
of a request. 



The relationship between the 
bits in the pattern at the end 
of an entry to the counters at 
the beginning of the entry is 

Bit of the first sense pattern 
byte is not used; bit 4 is used 
to increment one of the first 
two counters (temporary reod 
failures, temporary write failures); 
the remaining counters correspond 
to the remaining bits. 
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System Gen 



SUPRVSOR OPTIONS = 




The Channel Check 
Handler Routine is 
to be Included With 
the System. 



The system generation macro instructio 
are described in the publication OS 
System Generotion, GC28-&554. 



CCH Entry 
Indicator Byte 



Address of CCH 



The value in the 
indicotor byte 
establishes which 
I/O Supervisor 
routine intercepted 
the channel error. 
The value is ploced 
in the high-order 
byte of CATAPP by 
the I/O Supervisor 
routine that was being 
executed when the 
foilure occurred. 
CATAPP is then pi 
in register 15. 



:ed 



If a channel dato check, 
channel control check, or 
interface control check is 
detected by the I/O Supervisor, 
the Channel Check Handler 
will be invoked via 5ERR04, 
CCH will attempt to complete 
an ERPIB ond an Inboord Record 
about the channel error. 



Initial Entry Routii 



o 
o 



ERPIB Entry Find Routir 



Finds an i 



riloble 



'rocedure Interfoce 
ilock (ERPIB). 



Doto Collection Routi 



Finds an ovailable 
inboard record end 
fills in general 

Informal'Ion . 



e 



CCH outomatlcally 
kes the right 
jutine by using 

the volue in the 

indicator byte as an 
X to a list of 

bronch instructions. 



Branch Table Routine 



* +4 (index) 
CCHSSK — 
CCHTIOSK — 
CCHSNS — 
CCHTIOSN- 
CCHSIO - 
CCHINT - 
CCHHIO - 



T«. 






Diagram 14. Channel Check Handler 
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CCH Central (IGFCAT) 



o 



e 



o- 



o* 



Appropriate Interception- 
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Stand-Alone Seek/Stcrf 
I/O Interception Routine 



bense 

Interception Routin 



Interrupt 
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Holt I/O 
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logout or rT>Qv!ng of the 
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ERPIB. The channel- 
dependent analysis rou- 
tine also moves the log- 
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and clears the logout 
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tine then passes control 
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Checks for system 
terminotion condition. 
Stores ERPIB in inboord 
record and In ERPIB 
Table (unless record- 
only is indicoted) for 
the error recovery 
procedure fo use in 
retrying the operation . 



® 



<D 



The appropriate interception 
dependent routine first sets 
the appropriate bit in Se 
ERPIB to show where the 
channel error occurred . It 
then branches to ERPIBSET 
to nil in the ERPIB. 



UCB Search Routine 



Completes the Inboord 
record by filling in 
up to eight addresses 
of active units on the 
failing channel , 

If system termination 
is necessary, insures 
that on inboard record 
hos been completed 
before giving control 
to MCH to write 
record and place system 
in wait state. 




Appropriate Analysis Routin 



2860 Analysis Routine 
(IGFCCH60) 



28 70 Analysis Routi 
(IGFCCH70) 



2880 Analysis Routir 
(IGFCCH80) 



135 Analysis Routi 
(IGFCCH35) 



145 Analysis Routi 
(1GFCCH68) 



155 Analysis Routir 
(IGFCCH48) 



UCB Search passes control bock to 
the I/O Supervisor for the outboard 
recorder routine to write the 
inboord record on 5YS1 . LOGREC 
and to issue operator awareness message 
'IFB002I. The I/O Supervisor can then 
schedule on error recovery procedure- 
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Event Control Block. 
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Puts o Code 
Into Register 12, and 
, the Message 
Module (Fourth Load 
Module of IFBSTAT). 



Comple 
Code 




Code (Hex.) Meaning 



42 The I/O Activity was Not 
Started Because of a Direct 
Access Device Extent Violat 

<^ 44 The Request was Intercepted. 



7F The I/O Activity Completed Without Ei 



of thi 
Abo 



Diagram 15. Writing Environment Recording Error Messages to the Operator 
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A is Placed into Register 12 



No Message is Written. 



When the LOGREC Recorder 
Routine Reads the SYSl. LOGREC 
Data Set Header Record, it 
Checks the Sofety Field. If 
the Safety Field Contains Z 
Indicating a Serious Problem, 
the LOGREC Recorder Routine 
Puts a 4 into Register 12. 

An 8 is Placed into Register 12 



A is Placed into Register 12 






The Message Module 
Uses the Value it 
Finds in Register 12 
as an Index to a 
Branch Instruction. 
At the Branch to 
Address There is a 
Write- to-Opera tor 
Routine. 



/^ 



- BC 15, MSGO 

4- BC 15, MSGI ►- 

8- BC 15, MSG2 

12- BC 15, MSG3 ^S\_ 



\ 



IF6040I SYSl.LOGREC AREA IS FULL, HH.MM.SS 



IFB050I SYSl.LOGREC FORMAT ERROR, HH.MM.SS 



IFB030I SYSl.LOGREC I/O ACCESS ERROR, HH.MM.SS 



IFB060E SYSl.LOGREC NEAR FULL 
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Figure 12. Functional Organization of the I/O Supervisor 
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Functional Organization Chart 



In Figure 12, the major I/O supervisor routines are grouped according to the functions 
that they perform. Brief descriptions of the routines shown in the figure follow. 

Abnormal end appendage: Optional user-written appendage to which the I/O 
interruption supervisor exits when there is an error associated with the processing of 
I/O. 

Attention Routine Interface: Determines the address of the appropriate Attention 
routine; 

Channel Check Handler routine: Builds error recovery procedure interface block to 
indicate cause of channel failure; builds inboard record to describe environment at time 
of failure. 

Channel Check Handler Routine Interface (Channel Check Handler only): Places a code 
into register 15 that indicates which lOS routine intercepted the channel failure and 
branches to the Channel Check Handler routine. 

Channel end appendage: Optional user-written appendage to which the I/O 
interruption supervisor exits after a channel end interruption before indicating to the 
user how his I/O request ended. Also entered when channel end interruption is 
accompanied by either a wrong length indicator or a unit exception, or by both 
conditions. 

Channel Restart routine: Scans logical channel queues. Selects RQEs representing 
requests for I/O activity that can be started. Starts the I/O activity. For direct access 
devices, first starts all seeks, then starts the data transfer. 

Channel Search routines: One for every physical channel. "Driver" type routines 
consisting mostly of branch instructions. Direct the search of logical channel queues 
and the starting of I/O activity. 

Oe'iueue subroutine: Locates an R.QE in a logical channel ^ueue, removes it from the 
queue, and returns it to the freelist. 

End-of-extent appendage: Optional user-written appendage to which the EXCP 
supervisor exits when the execution of I/O request will violate the extent limits of a 
direct-access device. 

Enqueue subroutine: Places an RQE into a logical channel queue. Normally queues by 
order of arrival. Optionally queues by requestor's priority or by seek address. 

Error Recovery routine: Determines if I/O activity can be retried. Supervises retry 
attempts. 

Error Routine Interface: Prepares for and invokes, or schedules the execution of, an 
error recovery routine. 

EXCP Validity Check routine: Does most of the housekeeping for the EXCP 
supervisor. Checks for a valid DCB, DEB, lOB, and UCB. With Protection feature 
and MVT option, uses Validity Check subroutine to check storage keys of input data 
areas. 
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Get Request Element routine: Obtains an RQE from the t'reelist and initializes it. If 
device is unavailable, causes the RQE to be queued. 

Miscellaneous Data Recording routine: Generates miscellaneous error environment 
records for buffered log devices 2305, 321 1, and 3330, and for 2715 error data. 

Outboard Recorder routine: Builds outboard record to describe environment at time of 
I/O device failure. Writes outboard record onto SYSl.LOGREC data set. 

Program-controlled interruption appendage: Optional user-written appendage to which 
I/O interruption supervisor exits whenever a program--controlled interruption (PCI) is 
indicated. Returns control to I/O interruption supervisor where normal processing 
continues. 

Post Routine Interface: Invokes the supervisor's Post routine, passing to it an event 
completion code and the address of the requestor's ECB. The Post routine posts the 
requestor's ECB. 

Post Start I/O routine: Routes control, depending upon resulting condition codes of 
the Start I/O instruction and status bits in the CSW (if the CSW was stored). 

Quiesce Complete subroutine: Invokes the supervisor's Post routine, passing to it an 
event completion code and the address of the purge parameter list. The Post routine 
posts the Purge routine ECB. 

Sense subroutine: Issues a Start I/O instruction to cause a Sense command to be 
executed. Places the first two bytes of sense data in the requestor's lOB. 

SER Routine Interface: Places an error code into the machine check new PSW. Uses a 
Load PSW instruction to invoke the SERO or SERl routine. For the Model 65, 
invokes the Machine Check Handler routine. 

Start I/O appendage: Optional user-written routine to which the EXCP supervisor 
exits before the execution of the Start I/O (SIO) instruction for a requested I/O 
operation. 

Start I/O routine for direct-access devices: Prepares an I/O supervisor channel 
program consisting of three CCWs: a Seek command, a Set File Mask command, and 
a Transfer-in-Channel command. Uses the Start I/O subroutine twice, once to 
perform the seek and once to perform the data transfer. 

Start I/O routine for magnetic-tape devices: Prepares an I/O supervisor channel 
program that may consist of two CCWs (normal start, restart, or opposite direction 
recovery), or three CCWs (operations following a cyclic redundancy check condition). 
The last CCW contains a Transfer-in-Channel command containing the address of the 
requestor's first CCW. Uses the Start I/O subroutine. 

Start I/O routine for unit record and communications devices: Prepares a one-CCW 
channel program consisting of a Transfer-in-Channel command containing the address 
of the requestor's first CCW. Uses the Start I/O subroutine. 

Start I/O subroutine: Prepares the CAW and issues a Start I/O instruction. Does 
some checking of resulting condition codes. 

Statistics Update routine: Updates counters in statistics table entry for failing device. 

Test Channel routine: For selector channels, issues a Test Channel instruction. Causes 
the RQE to be queued if the channel is unavailable. Tries all channels of multiple-path 
arrangements. Does not issue a Test Channel instruction for byte-multiplexor 
channels. 
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Trap routines: One for each device class. Perform device-dependent functions 
following channel end and device end interruptions. 

Validity Check subroutine: MVT only. Checks storage keys of areas containing lOB, 
DCB, and ECB against the requestor's protection key; checks that DEB storage key is 
0. 



riowcnans 



This section contains flowcharts of I/O supervisor routines. In general, the flowcharts 
have the followin*^ characteristics; 

• Normal, 'no— error' type processing is shown vertically. To follow normal 
processing, read down a flowchart. 

• Symbols, or labels, are used where possible to aid readers in locating instruction 
sequences in listings. However, in cases where an instruction sequence does not 
have an associated label, a nearby label is sometimes used in the chart to indicate 
approximately where in the listing the function is performed. 

• Optional features are outlined to make them stand out. Where an option was not 
included in a generated system, read through the optional feature blocks; the 
corresponding instructions will most likely not appear in the program listings. 

• Where CPU control passes from one routine or subroutine to another, terminal 
blocks are always used. Offpage connectors are used only when a single routine 
or subroutine extends over two or more pages. 

• Redundancy is sometimes used to avoid excessive cross referencing; the same 
function may sometimes be shown in two or more flowcharts, even though in 
each case it is performed with the same set of instructions. 
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Chart 00. Input/Output Supervisor Overall Flow 



120 OS I/O Supervisor Logic 



Input/Output Supervisor 
Overall Flow 

I/O Interruption Supervisor;; 



EXCP Supervisor 



a 



o^ 




I.O 

Error 
Routine 



Return From the 
I/O Error Routine 
will be to the 
Error EXCP Supervisor 
(Above, Left) 



Place 
Requestor' 
RQE into 
Freelist 



i INT 027 " 



^ 



Interruptible 
for I/O 
Operations 



Prevent Furthe 

I/O 

Interruptions 



INTCSt) w 



Pending lO Interruptions 
will Occur at this Point 




r 



Prevent Furthe 
I O 
Interruptions 



O^O 




From Requestor of I O Operation, 
via Supervisor's SVC First Level 
Interruption Handler 



3 



To Supervisor's Type 1 
Exit Routine 



Pending l/O Interruptions 
will Occur at this Point 



To I O First Level 
Interruption Hondlf 



Build a Request 
Element 




Section 3: Program Organization 121 



c 



c 



From Super- 
Level Inten 
Handler 





Get TCB 
Address from 
TCB Old 



< 


Exit 


) 


To I/O Interruption 
Supervisor at INT027 
(Chart BC) 



Determine 
ABEND Code 



VALCHK t U" 


Put I/O Super- 
visor into 
User Protection 
Key 


VALCHK2' 


E4 


Access the 
lOB, DCB, 
and ECB 


' 


F4 


Put I/O Super- 
visor Back Into 
KeyO 


VALCHK3' 


. G4 




C]ID 



EXCP Entry - Return 
toXCP06IC 
Chart AA E2 

Interruption Entry — 
Return to Chart BA H2 




' 


No 

H5 


Get RQE 
Associated with 
Program Check 


1 


J5 


Clean up 
UCB Flags 


] 


K5 


Dequeue the 

RQE from the 
Logical Channel 



^ 



Chart AA. EXCP Validity Check Routine 



122 OS I/O Supervisor Logic 




Initialize 
the RQE 



Update Free list 
and Next AvailabU 



" G2 



Save RQE 
Pointer in 
LTSVALSV 




In MFT Systems, 
Outstanding I/O Inter- 
ruptions are Allowed to 
Occur Before Exit. 



© 


H4 
XCPPDQ 




H5 


Yes 




Remove 

Requestor's RQE 
from Queue 




Abnormal 

End 

Appendage 









To Supervisor's 
Type 1 Exit Routine 



To Test Ch. 
Routine (Ctiart AC 



From Test Channel Routine 
(Chart AC); Start I/O 
Routine for Direct Access 
Devices (Chart AH) 



The Return Vectors for on 
Abnormal End Appendage 
are Identical to Those of tl 
Channel End Appendage, 
Shown in Chart BC. 



Chart AB. Get Request Element Routine 



Section 3: Program Organization 123 



Byte MuItipleKor 

Channef 



En>iy 



XCPCH 



A2 ■•'': 

3 c 



Block Multiplexor ond 
Selechor Channel 
No Alternate Paths 
in Logicol Chonnel .^ 



Entrj' 



From Get Requesr Element 
Routine (Chon AS); Start I/O 
Subroulirw (Cl'firt AF); 
Pott Stort I/O Routine 
(Chart AL} 
82 



Get Chartnel 
Address 



XCPCH 



:) X 



Block MuhTpleKor and 
Selector Channel 
Alternate Paths 
n Logical Channel ^^ 



Entry 



from Get Request Elettwnt 
Routine (Chart AB); Start I/O 
Subroutine (Chart Af); 
Post Start I/O Routine 
' r(ChartAL) XCPCH 



Get Channel 
Address 




3 



From Get Request Elemer^t 
Routine (Chart AB); Stort I/O 
Subroutine (Chart AF); 
Post Start {/O Routine (Ctiart AL) 



Reposition Entries 
in Alternate Path 
Toble 



Issue TCH 

Instruction 




M 



Get Channel 
Addreu from 
Alternate Poth 
Table 



AM Paths 
Unavailable 



to Gel Request 
Element Routine at 
XCP020 (Chort AB) 
or Channel Restort 
at INT037 

D5 

To Get Request 
Element Routine 
ot XCro20 (Chort AB) 



Get Dev 
Address 



TCH Instruction Condition Codes: 



Chan 

1 Interruption renaing in v_nannei 

2 Channel Operating in Burst Mode 

3 Chonnel Not Ope-': 1 



el Available 

1 Pending in Channel 



Get Address c 
Stort I/O 
Routine 



c 



J 



To Device-Dependent 
Start I/O Routine: 

Start I/O Routine for Unit 
Record, Telecommunications, and 
Graphics Devices — Chart AD 

Start I/O Routines for 

Magnetic Tape Devices ~ Chart AE 

Start I/O Routine for 

Direct Access Devices — Charts AF and Al 



Chart AC. Test Channel Routines 



124 OS I/O Supervisor Logic 



Entry 



;) 



From Test 
Channel Routii 



Move Command 
Code into CCW 




To Post Start I/O 
Routine at XCPPIO 
(Chart AJ) 



Chart AD. Start I/O Routine for Unit Record, Communications and Graphics Devices 



Section 3: Program Organization 125 




C2 



Move Address 
of Requestor's 
'Start' CCW into 
Last I OS CCW 





No 

C3 


- XCP130 


Move Operation 


Code to Error 


Routine CCvV 



D3 



Move Address of 
Requestor's 
'Restart' CCW 
into Last 
lOS CCW 




Move' Set Mode' 
Command Code 
into First lOS 
CCW 



XCPSIO AKA2 



Execute Start 
I/O Instructic 



c 



Start I/O 
Subroutine 



3 



To Post Start I/O 
Routine at XCPPIO 
(Chart AL) 



3400 Tape Devices Only 



f Entry J 





XIOTPOO u 



Reset UNSOL 
Interrupt 
Flag in UCB 



XCPPDQ 


H5 


Remove 


Requestors 


RQE From 


Queue 




. J5 



To Error Routine 
Interface at INT022 
(Chart BF) 



Chart AE. Start I/O Routine for Magnetic Tape Devices 



126 OS I/O Supervisor Logic 
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Section 3: Program Organization 135 




From I 
Rootir 



( Entry J 



From Start 
I/O Sub- 
Routine 
(Chart AK) 



D2 
lEAOPTOl 



Place Com- 
pletion Code 
Into Request- 
or's ECB 



INT025 
INT024B 



Supervisor' 

Post 

Routine 



Get Address 
of Logical 
Channel Word 



E2 
PRGCOMB 



Place 

Completion 
Code into 
Purge 
Routine ECB 



INT025A " F2 



Quiesce 
Complete 
Subroutine 
(Uses the 
Supervisor' 
Post Routin 



^' XCPPNQB 



Place 

Requestor's 
RQE in Qu 



Place 

Requestor's 
RQE into 
Freelist 



© 




Supervisor's Task 
itching Routine 



Save Channel's 
Address for a 
Later Restart 




This Part of the I/O 
Interruption Supervisor, 
Beginning with INT027, 
also Referred to as the 
Channel Restart Routine. 
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Chart BC (Part 3 of 5). I/O Interruption Supervisor 
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Chart BD (Part 4 of 5). I/O Interruption Supervisor 



Section 3: Program Organization 137 




)From 
Start 
(Choi 



From Post 

I/O Routii 
(Chort AL) 




Attentioi 
Routine 



Routine Provided! 



The Return Vectors for 
on Abnormal End Appendage 
ore Identical to Those of 
the Channel End Appendage, 
Shown in Chart BC 



Supervisors 

Attention Routine (MVT) 

Job Management 
Console Interruption 
Routine (MPT) 

Graphics Access Method 
Attention Handling Routin 
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Chart BE (Part 5 of 5). I/O Interruption Supervisor 
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Chart BG (Part 1 of 2). Sense Subroutine 
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For Additional Information, See Diagram 14, 
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Chart BI (Part 1 of 3). Channel Check Handler 
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Abnormal 

End 

Appendage 





Chart BM. Channel Search Routine, No Alternate Paths 
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Chart BO (Part 1 of 2). Channel Search Routine, Byte-Multiplexor Channel 
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Chart DA. Operator-Initiated DDR Routine 
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Chart DB. System-Initiated DDR Routine 
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Chart DC. DDR Tape Reposition Routine 
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Table 33 contains information about the physical structure of the I/O supervisor. The 
column headings and their meanings are: 

Symbolic Name: The symbolic name of a table, routine, object module, or control 
section. 

Description: The type of item to which the symbolic name applies. 

Object Module Name: The name of the object module containing the item. The 
microfiche cards containing program listings are ordered by object module name. 

Control Section Name: The name of the control section containing the item. 

PLM References: Places in this publication where more information about the item can 
be found. 

Library: The data set normally containing the item. 

Code Data Set 

NUC SYS 1. NUCLEUS 

SVC SYSl.SVCLIB 

If SVC Routine: Information about I/O supervisor SVC routines. There are four types 
of SVC routines. 

Type 1 SVC routines are part of the nucleus and are disabled (masked) for all 
interruptions except machine check interruptions. 

Type 2 SVC routines are part of the nucleus but may be enabled (interruptable) 
for part of their operation. 

Type 3 SVC routines are nonresident, may be enabled, and are not larger than 
1024 bytes. 

Type 4 SVC routines are nonresident, may be enabled, and are larger than 1024 
bytes. They are brought into storage in segments of up to 1024 bytes. 

Name: The name of the item being described. 

When the control section name for an item is not the same as the object module name, 
the item will have two entries in the table — one filed by control section name and the 
other filed by object module name. Therefore, it is unnecessary to check beyond the 
first column when looking for a symbolic name. 

The three major groups of routines that make up the I/O supervisor — the EXCP 
supervisor, the I/O interruption supervisor, and the error EXCP supervisor — are 
contained in the control program nucleus. As a result, there are no CSECT names or 
load module names in these three major groups of routines. Linkage parameter lists, 
usually associated with multi-load routines, are also unnecessary. Therefore entry 
points are not of the formal one-or-two-entries-only type (due to stringent parameter 
list requirements), but rather are ordinary symbolic labels, undistinguishable from other 
symbolic labels. 
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Table 33 (Part 1 of 5). I/O Supervisor Module Directory 



Symbolic 
Name 


Description 


Object 
Module 
Name 


Control 
Section 
Name 






Library 


If SVC Routine 


Name 




Type 


Macro 
Instruction 


SVC 
No. 


Section 


Chart 


CAWLOC 


Table 


* 


* 


5 












Channel Address Word 


CSWLOC 


Table 


* 


* 


5 












Channel Status Word 


DEVTAB 


Table 


* 


* 


5 




NUC 








Device Table 


lECCST 


Table 


* 


* 


5 




NUC 








Channel Table 


lECILCH 


Table 


* 


* 


5 




NUC 








Logical Channel Table 


lECILKl 


Table 


* 


* 


5 




NUC 








UCB Lookup Table 


lECINT 


Routine 


* 


* 


3 


BA-BE 


NUC 








I/O Interruption Supervisor 


lECINTRP 


Object Module 


lECINTRP 


lECINTRP 


2 




NUC 








Error Interpreter Routine 


lECIOQET 


Table 


* 


* 


5 




NUC 








Request Queue Element Table 


lECIPRMP 


Object Module 


lECIPRMP 


IGC016 


7 




SVC 


2 


PURGE 


16 


Purge Routine (Model 65 Multiprocessing) 


lECIPRTS 


Object Module 


lECIPRTS 


IGC016 


7 




SVC 


2 


PURGE 


16 


Purge Routine (TSO) 


lECIPRlA 


Object Module 


lECIPRlA 


IGC016A 


7 




SVC 


4 


PURGE 


16 


Purge Routine, Load 2 of 3 (MET) 


lECIPRlB 


Object Module 


lECIPRlB 


IGC016B 


7 




SVC 


4 


PURGE 


16 


Purge Routine, Load 3 of 3 (MPT) 


IECIPR12 


Object Module 


IECIPR12 


IGC016 


7 




SVC 


4 


PURGE 


16 


Purge Routine, Load 1 of 3 (MET) 


IECIPR16 


Object Module 


IECIPR16 


IGC016 


7 




SVC 


2 


PURGE 


16 


Purge Routine (MVT) 


lECSTATA 


Control Section 


IGE0025D 


lECSTATA 


2 




SVC 








Statistics Update Routine 


lECSTB 


Table 


* 


* 


5 




NUC 








Statistics Table 


lECWTORA 


Control Section 


IGE0025C 


lECWTORA 


2 




SVC 








Write-to-Operator Routine, Load 1 of 5 ' 


lECWTORB 


Control Section 


IGE0125C 


lECWTORB 


2 




SVC 








Write-to-Operator Routine, Load 2 of 5 ' 


lECWTORC 


Control Section 


IGE0225C 


lECWTORC 


2 




SVC 








WrIte-to-Operator Routine, Load 3 of 5 ^ 


lECWTORD 


Control Section 


IGE0325C 


lECWTORD 


2 




SVC 








Write-to-Operator Routine, Load 4 of 5 ' 


lECWTORE 


Control Section 


IEC0425C 


lECWTORE 


2 




SVC 








Write-to-Operator Routine, Load 5 of 5 ^ 


1 EC 1052 A 


Control Section 


IGEOOOOD 


1 EC 1052 A 


2 




SVC 








1052 Error Routine 


1 EC 1402 A 


Control Section 


IGEOOOIC 


1 EC 1402 A 


2 




SVC 








2540 Error Routine, Load 1 of 2 


IEC1402B 


Control Section 


IGEOIOIC 


IEC1402B 


2 




SVC 








2540 Error Routine, Load 2 of 2 


IEC1403A 


Control Section 


IGEOOOOG 


IEC1403A 


2 




SVC 








1403 and 1443 Error Routine 


1 EC 1442 A 


Control Section 


IGEOOOOE 


IEC1442A 


2 




SVC 








2501, 2520, and 1442 Error Routine 


IEC23XXF 


Object Module 


* 


* 


2 




NUC 








2301, 2302, 2303, 2305, 2311, 2314, 
2321 and 3330 Error Routine 


IEC2400I 


Control Section 


IGE0900I 


IEC24001 


2 




SVC 








2400/3400 Tape Series Error Routine, Load 6 of 6 



* Refer to installation system generation listing. 

1 Do not confuse with the Write-to-Operator SVC routine (SVC 35), described in the publications: 

OS MET Job Management Logic , GY27-7128 
OS MVT Supervisor Logic , GY28-6659 
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Table 33 (Part 2 of 5). I/O Supervisor Module Directory 



Symbolic 
Name 


Description 


Object 
Module 
Name 


Control 
Section 
Name 


PLM References 




If SVC Routine 


Name 


Type 


Macro 
Instruction 


SVC 
No. 


Section 


Chart 


Library 


IEC2671A 


Control Section 


IGE0002I 


IEC2671A 


2 




SVC 








2671 Error Routine 


IEC3211A 


Control Section 


IGEOOOOF 


IEC3211A 


2 




SVC 








3211 Error Routine 


IEC3211B 


Control Section 


IGEOIOOF 


IEC3211B 


2 




SVC 








32 1 1 Error Routine 


IFBSTAT 


Object Module 


IFBSTAT 


IGC0007F 


2,7 




SVC 


3 


-none- 


76 


SYS1.LOGREC Recording Routine 


IGCOOO 


Routine 


* 


* 


3 


AA-AI 


NUC 


1 


EXCP 





EXCP Supervisor 


IGCOOOIG 


Object AAodule 


IGCOOOIG 


SVC0I7 


7 




SVC 


3 


RESTORE 


17 


Restore Routine 


IGC0003C 


Object Module 


IGC0003C 


IGC00033 


7 




SVC 


3 


lOHALT 


33 


lOHALT Routine 


IGC00033 


Control Section 


IGC0003C 


IGC00033 


7 




SVC 


3 


lOHALT 


33 


lOHALT Routine 


IGC0007F 


Object A/tedule 


IFBSTAT 


IGC0007F 


7 




SVC 


4 


-none- 


76 


SYSl.LOGREC Recorder Load 1 of 4 


IGC0008E 


Object Module 


IGC0008E 


IGC0008E 


7 




SVC 


4 


-none- 


85 


DDR SVC Router, Initiator, Terminator Routine 


IGC0009A 


Object AAodule 


IGC0009A 


IGC0009A 


7 




SVC 


3 


-none- 


91 


VOLSTAT Routine 


IGCOOIOA 


Object Module 


IGCOOIOA 


IGCOOIOA 


7 




SVC 








Loads 2305/3330 


IGC0024 


Control Section 


IGC0002D 


IGC0024 


7 




SVC 


3 


DEVTYPE 


24 


DEVTYPE Routine 


IGC0107F 


Object Module 


IFBSTATl 


IGC0107F 


7 




SVC 


4 


-none- 


76 


SYSl.LOGREC IPL-EOD Load 3 of 4 


IGC0108E 


Object Module 


IGC0108E 


IGC0108E 


7 


DA 


SVC 


4 


-none- 


85 


Operator-Initiated DDR Routine 


IGC015 


Routine 


* 


* 


3 


CA 


NUC 


1 


-none- 


15 


Error EXCP Supervisor 


IGC016 


Control Section 


lECIPRMP 


IGC016 


7 




SVC 


2 


PURGE 


16 


Purge Routine (Model 65 Multiprocessing) 


IGC016 


Control Section 


lECIPRTS 


IGC016 


7 




SVC 


2 


PURGE 


16 


Purge Routine (TSO) 


IGC0I6 


Control Section 


IECIPR12 


IGC016 


7 




SVC 


4 


PURGE 


16 


Purge Routine, Load 1 of 3 {PCP & MFT) 


IGC016 


Control Section 


IECIPR16 


IGC016 


7 




SVC 


2 


PURGE 


16 


Purge Routine (MVT) 


IGC016A 


Control Section 


lECIPRlA 


IGC016A 


7 




SVC 


4 


PURGE 


16 


Purge Routine, Load 2 of 3 (PCP & MFT) 


IGC016B 


Control Section 


lECIPRlB 


IGC016B 


7 




SVC 


4 


PURGE 


16 


Purge Routine, Load 3 of 3 (PCP & MFT) 


IGC0207F 


Object Module 


IFBSTAT2 


IGC0207F 


7 




SVC 


4 


-none- 


76 


SYSl.LOGREC Message Routine Load 4 of 4 


IGC0208E 


Object AAodule 


IGC0208E 


IGC0208E 


7 


DB 


SVC 


4 


-none- 


85 


System-Initiated DDR Routine, Load 1 of 2 


IGC0307F 


Object Module 


IFBSTATO 


IGC0307F 


7 




SVC 


4 


-none- 


76 


SYSl.LOGREC Statistics Function Load 2 of 4 


IGC0308E 


Object Module 


IGC0308E 


IGC0308E 


7 


DB 


SVC 


4 


-none- 


85 


System-Initiated DDR Routine, Load 2 of 2 


IGC0408E 


Object Module 


IGC0408E 


IGC0408E 


7 


DC 


SVC 


4 


-none- 


85 


DDR Tape Reposition Routine, Load 1 of 2 


IGC0508E 


Object AAodule 


IGC0508E 


IGC0508E 


7 


DC 


SVC 


4 


-none- 


85 


DDR MSG Mod *1 


IGC0608E 


Object Module 


IGC0608E 


IGC0608E 


7 


DC 


SVC 


4 


-none- 


85 


DDR Tape Reposition Routine, Load 2 of 2 


IGC0708E 


Object AAodule 


IGC0708E 


IGC0708E 


7 




SVC 


4 


-none- 




DDR Recording 


IGC0808E 


Object Module 


IGC0808E 


IGC0808E 


7 




SVC 


4 


-none- 




DDRMSG Mod *2 


IGC092 


Routine 


* 


* 


7 




NUC 


1 


-none- 


92 


TCB EXCP Routine (TSO) 



Refer to installation system generation listing. 
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Table 33 (Part 3 of 5). I/O Supervisor Module Directory 



Symbolic 
Name 


Description 


Object 
Module 
Name 


Control 
Section 
Name 






Library 


If SVC Routine 


Name 




Type 


Macro 
Instruction 


SVC 
No. 


Section 


Chart 


IGC2503D 


Object Module 


IGC2503D 


IGF2503D 


7 




SVC 








DDR Swap Command Processor Routine 


IGEOOOOD 


Object Module 


IGEOOOOD 


IEC1052A 


2 




SVC 








1052 Error Routine 


IGEOOOOE 


Object Module 


IGEOOOOE 


1 EC 1442 A 


2 




SVC 








2501, 2520, and 1442 Error Routine 


IGEOOOOF 


Object Module 


IGEOOOOF 


IEC3211A 


2 




SVC 








3211 Error Routine 


IGEOOOOG 


Object Module 


IGEOOOOG 


IEC1403A 


2 




SVC 








1403 and 1443 Error Routine 


IGEOOOOI 


Object Module 


IGEOOOOI 


IGEOOOI 


2 




SVC 








2400/3400 Tope Series Error Routine,Loadlof 6 


IGEOOOIC 


Object Module 


IGEOOOIC 


IEC1402A 


2 




SVC 








2540 Error Routine, Load 1 of 2 


iGE0002l 


Object Module 


IGE0002I 


IEC2671A 


2 




SVC 








2671 Error Routine 


IGEOOIOA 


Object Module 


IGEOOIOA 


IGEOOIOA 


2 




SVC 








2250 Error Routine 


IGEOOlOf, 


Object AAbdule 


IGE0010B 


IGEOOIOB 


2 




SVC 








2260 and 1053 Error Routine, Load 1 of 2 


IGEOOIOD 


Object Module 


IGEOOIOD 


IGEOOIOD 


2 




SVC 








5450 Error Routine 


IGEOOllA 


Object Module 


IGEOOllA 


IGEOOllA 


2 




SVC 








2495 Error Routine 


IGEOOllB 


Object Module 


IGEOOllB 


IGEOOllB 


2 




SVC 








1285 Error Routine 


IGEOOllC 


Object Module 


IGEOOllC 


IGEOOllC 


2 




SVC 








1287 Error Routine 


IGEOOllD 


Object Module 


IGEOOllD 


IGEOOllD 


2 




SVC 








1288 Error Routine 


IGEOOllE 


Object Module 


IGEOOllE 


IGEOOllE 


2 




SVC 








1419/1275 Error Routine 


IGE0025C 


Object Module 


IGE0025C 


lECWTORA 


2 




SVC 








WrIte-to-Operator Routine, Load 1 of 5 1 


IGE0025D 


Object Module 


IGE0025D 


1 EC ST AT A 


2 




SVC 








Statistics Update Routine 


IGE0025E 


Object AAodule 


IGE0025E 


IGE0025E 


2 




SVC 








I/O Purge Routine 


IGE0025F 


Object Module 


IGE0025F 


IGE0025F 


2 




SVC 








Outboard Recorder Routine, Load 1 of 2 


IGEOIOOF 


Object Module 


IGEOIOOF 


IEC3211B 


2 




SVC 








3211 Error Routine, Load 2 of 2 


IGEOIOOI 


Object AAodule 


IGEOIOOI 


IGEOIOOI 


2 




SVC 








2400/3400 Tape Series Error Routine, Load 2 of 6 


IGEOIOIC 


Object Module 


IGEOIOIC 


IEC1402B 


2 




SVC 








2540 Error Routine, Load 2 of 2 


IGEOllOB 


Object Module 


IGEOllOB 


IGEOllOB 


2 




SVC 








2260 and 1053 Error Routine, Load 2 of 2 


IGE0125C 


Object Module 


IGE0125C 


lECWTORB 


2 




SVC 








Write-to-Operator Routine, Load 2 of 5 ' 


IGE0125E 


Object Module 


IGE0125E 


IGE0125E 


7 




SVC 








Volume Verification Routine, Load 1 of 2 


IGE0125F 


Object Module 


IGE0125F 


IGE0125F 


2 




SVC 








Outboard Recorder Routine, Load 2 of 2 



* Refer to installation system generation listing. 

1 Do not confuse with the Write-to-Operator SVC Routine (SVC 35), described in the publications: 

OS MFT Job Management Logic , GY27-7128. 
OS MVT Supervisor Logic. GY28-6659. 
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Table 33 (Part 4 of 5). I/O Supervisor Module Directory 



Symbolic 
Name 


Description 


Object 
Module 
Name 


Control 
Section 
Name 






Library 


If SVG Routine 


Name 


PLM References 


Type 


Macro 
Instruction 


SVC 
No. 


Section 


Chart 


IGE0200I 


Object Module 


IGE0200I 


IGE0200I 


2 




SVC 








2400/3400 Tope Series Error Routine,-I_ood 3 of <S 


IGE0225C 


Object Module 


IGE0225C 


1ECWTORC 


2 




SVC 








Write-to-Operator Routine, Load 3 of 5 ' 


IGE0225E 


Object Module 


IGE0225E 


IGE0225E 


7 




SVC 








Volume Verification Routine, Load 2 of 2 


IGEOaOO! 


Object Module 


IGE0300I 


IGEO3OOI 


2 




SVC 








2400/3400 Tape Series Error Routine, Load 4 of 6 


IGE0325C 


Control Section 


IGE0325C 


lECWTORD 


2 




bVC 








\A/r:»e_fj;_Op2.j,tj;, Routinc, Locd 4 of 5 ' 


IGE0400I 


Object Module 


IGE0400I 


IGE0400I 


' 




SVC 








2400/3400 Tape Series Error Routine, Load 5 of 6 


IGE0625F 


Object Module 


IGE0625F 


IGE0525F 


2 




SVC 








Miscellaneous Data Recording Routine 


IGE0425C 


Control Section 


IGE0425C 


lECWTORE 


2 




SVC 








Write-to-Operator Routine, Load 5 of 5 ^ 


IGE0425F 


Object AAodule 


IGE0425F 


IGE0425F 


2 




SVC 








System Environment Recording Message Routine 


IGE0660A 


Object Module 


IGE0660A 


IGE0660A 


7 




SVC 








DDR Central Routine 


IGE0900I 


Object AAodule 


IGE0900I 


IEC2400D 


2 




SVC 








2400/3400 Tape Series Error Routine, Load 6 of 6 


IGFCAT 


Routine 


* 


IGFCAT 


3 


Bl 


NUC 








Channel Check Handler Routine 


iGFCCH35 


Object Module 


IGFCCH35 


IGFCCH35 


7 


BK 


LINK 








Channel Dependent Analysis for 135 


IGFCCH48 


Object /Vtedule 


IGFCCH48 


IGFCCH35 


7 


BK 


LINK 








Channel Dependent Analysis for 155 


IGFCCH60 


Object Module 


IGFCCH60 


IGFCCH60 


3 


Bl 


LINK 








Channel Dependent Analysis for 2860 


IGFCCH68 


Object Module 


IGFCCH68 


IGFCCH68 


7 


BK 


LINK 








Channel Dependent Analysis for 145 


IGFCCH70 


Object Module 


IGFCCH70 


IGFCCH70 


3 


Bl 


LINK 








Channel Dependent Analysis for 2870 


IGFCCH80 


Object Module 


IGFCCH80 


IGFCCH80 


7 


BK 


LINK 








Channel Dependent Analysis for 2880 


IGFDDRMF 


Object Module 


IGFDDRMF 


IGFDDRMF 


7 




SVC 








DDR Wait Routine (MFT) 


IGFDDRMV 


Object Module 


IGFDDRMV 


IGFDDRMV 


7 




SVC 








DDR Wait Routine (MVT) 


IGFDDRSR 


Control Section 


IGFDDROO 


IGFDDRSR 


7 




SVC 








DDR SYSRES Routine (Without MCS) 


IGFDDRSR 


Control Section 


IGFDDRIO 


IGFDDRSR 


7 




SVC 








DDR SYSRES Routine (With MCS) 


IGFDDROO 


Object Module 


IGFDDROO 


IGFDDRSR 


7 




SVC 








DDR SYSRES Routine (Without MCS) 


IGFDDROl 


Object Module 


IGFDDRMV 


IGFDDROl 


7 




SVC 








DDR Resident Module 


IGFDDR02 


Object Module 


IGFDDR02 


IGFDDR02 


7 




SVC 








DDR Channel End Appendages 


IGFDDR03 


Object Module 


IGFDDR03 


IGFDDR03 


7 




SVC 








DDR Abnormal End Appendage 


IGFDDRIO 


Object Module 


IGFDDRIO 


IGFDDRSR 


7 




SVC 








DDR SYSRES Routine (With MCS) 


IGF2503D 


Control Section 


IGC2503D 


IGF2503D 


7 




SVC 








DDR Swap Command Processor Routine 


IGX00015 


Object Module 


IGX00015 


IGX00015 


7 




SVC 








Extended SVC Routine 


INTAPROl 


Routine 


* 


* 


7 


EA 


NUC 








Alternate Path Retry Routine 


INTATT 


Routine 


* 


* 


3 


Al 


NUC 








Attention Routine Interface 


INTCS17 


Routine 


* 


* 


3 


BN-BP 


NUC 








Channel Search Routine 



Refer to installation system generation listing. 
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Table 33 (Part 5 of 5). I/O Supervisor Module Directory 



Symbolic 
Name 


Description 


Object 
Module 
Name 


Control 
Section 
Name 






Library 


If SVC Routine 


Nome 




Type 


Macro 
Instruction 


SVC 
No. 


Section 


Chart 


INTDAT 


Routine 


* 


* 


3 


BB 


NUC 








Trap Routine for Direct Access Devices 


INTERR 


Routine 


* 


* 


3 


BF 


NUC 








Error Routine Interface 


INTSEN 


Routine 


* 


* 


3 


BG-BH 


NUC 








Sense Subroutine 


INTTAT 


Routine 


* 


* 


3 


BB 


NUC 








Trap Routine for Magnetic Tape Devices 


INTURT 


Routine 


* 


* 


3 


BB 


NUC 








Trap Routine for Unit Record and 
Communications Devices 


INT027 


Routine 


* 


* 


3 


BC 


NUC 








Channel Restart Routine 


lONPSW 


Table 


* 


* 


5 












I/O New PSW 


lOPSWO 


Table 


* 


* 


5 












I/O Old PSW 


LCHTAB 


Table 


* 


* 


5 




NUC 








Logical Channel Table 


PRGCOMA 


Routine 


* 


* 


7 




NUC 








Quiesce Complete Subroutine 


SERR04 


Routine 


* 


* 


3 


AL,BA, 
BH 


NUC 








SER/CCH Routine Interface 


SVCOPSW 


Table 


* 


* 


5 












SVC Old PSW 


SVC017 


Control Section 


IGCOOOIG 


SVC017 


7 




SVC 


3 


RESTORE 


17 


Restore Routine 


TSTAR 


Table 


* 


* 


5 




NUC 








Request Queue Element Table 


UCBTAB 


Table 


* 


* 


5 




NUC 








UCB Lookup Table 


VALCHK 


Routine 


* 


* 


3 


AA 


NUC 








Validity Check Subroutine 


XCPCHjj 


Routine 


* 


* 


3 


AC 


NUC 








Test Channel Routine 


XCPPDQ 


Routine 


* 


* 


3 


** 


NUC 








Dequeue Subroutine 


XCPPIO 


Routine 


* 


* 


3 


AL 


NUC 








Post Start I/O Routine 


XCPPNQ 


Routine 


* 


* 


3 


AB 


NUC 








Enqueue Subroutine 


XCPPST 


Routine 


* 


* 


3 


BC 


NUC 








Post Routine Interface 


XCPSIO 


Routine 


* 


* 


3 


AK 


NUC 








Start I/O Subroutine 


XCPTST 


Routine 


* 


* 


3 


AB 


NUC 








Get Request Element Routine 


XIODSKl 


Routine 


* 


* 


3 


AF-AG 


NUC 








Start I/O Routine for Direct Access Devices 


XIOTPE 


Routine 


* 


* 


3 


AE 


NUC 








Start I/O Routine for Magnetic Tape Devices 


XIOUR 


Routine 


* 


* 


3 


AD 


NUC 








Start I/O Routine for Unit Record and 
Communications Devices 


. XVCKOl 


Routine 


* 


* 


3 


AA 


NUC 








EXCP Validity Check Routine 



Refer to installation system generation listing. 
* Refer to XCPPDQ in the Symbol Table for flowcharts showing the Dequeue Subroutine. 
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Data Area Directory 



Table 34 contains a summary of information about the major data areas used by the 
I/O supervisor. The column headings and their meanings are: 

Data Area Name: The name of the data area and its abbreviation, if there is one. 

Beginning S>'mbG!: Meaningful only for data areas contained in the nucleus. This 
symbol identifies the beginning of the data area, and can be used to locate the data 
area in the program Ustings. 

Creation: Contains some indication as to the origin of the data area. 

Permanent Storage Assignment means that the area is part of the hardware and 
always occupies the main-storage location shown in the "Storage Area" column. 

Requestor means that creation and maintenance of the data area is the 
responsibihty of the requestor of the I/O activity. All requestors do not have to 
explicitly create the needed data areas. (See Figure 1 and its accompanying text.) 

System Generation means that the data area is created during system generation. 
(This may mean simply that space is set aside for the area during system 
generation.) 

Supervisor means that the area is created and maintained by the supervisor 
portion of the control program. 

Storage Area: Indicates where the data area can be found in main storage. Where 
"Requestor's" appears in this column, the data area is obtained by the requestor when 
it is needed; consequently, its location is not fixed. 

Size: The size of the data area. 

Means of Access: The most commonly used way of referring to the data area or one of 
its entries. 
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Table 34 (Part 1 of 2). Data Area Directory 



Data Area Name 


Beginning 
Symbol 


Creation 


Storage Area 


Size 


Means of Access 


Alternate Path Table 


XCPCHnB 


System Generation 


Nucleus 


Three to Five 
Fuilwords, 
Depending Upon 
No. of Paths to 
a Device 


Beginning symbol. 


Channel Address Word (CAW) 


CAWLOC 


Permanent Storage 
Assignment 


72 (48) 


Word 


Beginning symbol. 


Channel Availability Table 
(M65MP Option Only) 




System Generation 


Prefixed Storage 
Area 


14 Bytes 


The entry for each channel is addressable via an 
offset from the label CHANG. The offset is 
based upon the channel address. 




Channel Command Word (CCW) 




By Requestor when 
Needed. lOS 
CCWs ore Created 
during System 
Generation 


Requestor's; 
Nucleus 


Double Word 


Address at requestor's first CCW is contained at off- 
sets lOBST (start) or lOBSRS (restart) fields of lOB. 

Access to lOS CCWs varies with device type and 
circumstances. See Diagrams 4-7 in Section 2. 




Channel Error Block Table 


CEBTAB 


System Generation 


Nucleus 


24 Bytes 


Beginning symbol. 


Channel Status Word (CSW) 


CSWLOC 


Permanent Storage 
Assignment 


64 (40) 


Double Word 


Beginning symbol. 


Channel Table 


lECCST 


System Generation 


Nucleus 


One-Word Entry 
for Each Physical 
Channel 


To locate entry for specific channel, channel 
number is multiplied by four and added to 
beginning address of table. 


Data Control Block (DCB) 




By Requestor 


Requestor's 


Varies with 
Access Method 


Symbolic names equated to offsets of fields. 




Data Extent Block (DEB) 




By Requestor 


Requestor's 


Varies with 
Device and 
Access Method 


Symbolic names equated to offsets of fields. 




Device Statistics Table 


lECSTB 


System Generation 


Nucleus 


One 10- Byte 
Entry for Each 
Device, plus 
One 10 Byte 
Control Field 


Normally, the address of an entry for a device is 
obtained by multiplying the statistics table index 
in the device's UCB by 10 and adding the result 
to the beginning address of the device statistics 
table: 

STATAB x 10 + Beginning Address 

When there are more than 256 devices, however, 
the following method is used: 

(STATAB + 256ij) x 10 + Beginning Address 

In the above, tj is the number one or two to 
indicate the second and third 256-entry group 
in the device statistics table. The UCB addresses 
in the control field of the table are used to 
determine the number t). 

For the 2314 Direct Access Storage Facility, the 
low-order four bits of the fifth sense byte are addec 
to the statistics table index before the index is 
used. 


Device Table 


DEVTAB 


System Generation 


Nucleus 


One 6- Byte 
Entry for Each 
Queuing Option 
Selected for Each 
Device Type 


Desired entry located by adding device table index 
from UCB to beginning address of table. A specific 
field within the entry is then located by adding the 
field's offset to the above sum. 


Error Recovery Procedure 
Interface Blocks (ERPIB) 




By Channel Check 
Handler 


Nucleus 


Double Word 


I/O error routines find the ERPIB by 1) obtaining 
the address of the SYSl. LOGREC DCB, 2) obtain- 
ing the address of the SYSl. LOGREC parameter 
table from the field at offset in the DCB, and 
3) obtaining the address of the ERPIB from a field 
at offset in the SYSl. LOGREC parameter table. 
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Table 34 (Part 2 of 2). Data Area Directory 





Beginning 










Data Area Name 


Symbol 


Creation 


Storage Area 


Size 


Means of Access 


Event Control Block (ECB) 
Input/Output Block (lOB) 




By Requestor 
By Requestor 


Requestor's 
Requestor's 


Word 
32 Bytes, plus a 


Via address contained at offset 5 of the lOB. 
Initially, address is provided in register 1 by 














Variable Amount 


requestor. It is moved to and maintained in 










that Depends Upon 


register 2 (lOBREG). 










the Access iVietnOu 




Logical Channel Table (LCH) 


LCHTAB 


System Generation 


Nucleus 


One Double- 


To locate a needed logical channel word, the 




lECILCH 






Word Logical 
Channel Word 
for Each Logical 
Channel Q..*.ue 


logical channel index in the UCB is multiplied by 8 
and added to the beginning address of the logical 
channel table. 


Program Status Word (PSW) 




Permanent Storage 
Assignment 








SVC Old PSW 


SVCOPSW 




32 (20) 




Beginning symbol- 


I/O Old PSW 


1 OPS WO 




56 (38) 




Beginning symbol. 


I/O New PSW 


lONPSW 




120 (78) 




Beginning symbol. 


Recovery Management Support 


lORMS 


System Generation 


Nucleus 


112 Bytes 


An lORMSCOM macro instruction is used to build 


Communication Area 










a DSECT. The address for the base register is 
obtained from the field at offset of the 
SYSl.LOGREC DCB. 


Request Queue Element (RQE) 


TSTAR 
TECIOQET 


System Generation 


Nucleus 


12 Bytes (MFT) 
16 Bytes (MVT) 


Varies depending upon status of request: 

Address of RQE available for assignment is 
contained in location NEXAVL. 

Address of assigned (but not queued) RQE is 
contained in register 1 (TSTREG). 

Address of the first RQE in a logical channel 
queue is contained in the LCHFTS field of the 
logical channel word for that queue. 


Task Control Block (TCB) 




By Supervisor 


Nucleus 


171 Bytes 


Symbolic names equated to offsets of fields. 




Unit Control Block (UCB) 




System Generation 


Nucleus 


Variable from 24 


Initially, via address contained in UCB address 












to 288 Bytes. 


field of DEB. The address is moved to the request 










One UCB for Each 


queue element. Following interruptions, the 










Device Address 


address of the UCB for the device that caused the 










Defined for the 


interruption is obtained via the UCB lookup table. 










System. 




UCB Lookup Table 


UCBTAB 
lECILKl 


System Generation 


Nucleus 


Variable, de- 
pending upon 
Number and 
Addresses of 
Devices, 
Control Units, 
and Channels, 
and Number of 
Zero Entries 
Eliminated by 
Table- Building 
Routine. 


Beginning symbol. 


Volume Statistics Table 




System Generation 


Nucleus 


24 Bytes for 


Via address contained in field at offset 49 of the 












Each Entry 


UCB containing the volume. Each entry is 
effectively an extension to a UCB. 
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Symbol Table 



Symbols (or labels) are the same as those found in program listings and in the 
flowcharts (Program Organization section) of this manual. To find a flowchart for a 
labeled segment of code, look for the label in the table's Symbol column. If you find 
the label, a flowchart ID will be listed next to it in the chart column. 



Symbol 



Chart 



BRTABLE 


DB 


CCHHIO 


BI 


CCHINT 


BI 


CCHQUIT 


BI 


CCHSIO 


BI 


CCHSNS 


BI 


CCHSSK 


BI 


CCHTIOSK 


BI 


CCHTIOSN 


BI 


CCH005 


BI 


CCH007 


BI 


CCH009 


BI 


CCH035 


BI 


CCH041 


BI 


CCH044 


BI 


CCH045 


BI 


CHKREPLY 


DC 


CKWAITQ 


DC 


COMPLAB 


DC 


DDRDEVCK 


DB 


DDROOO 


DB 


DDROl 


DB 


DDR02 


DB 


DDR03A 


DB 


DDR03B 


DB 


DDR05 


DB 


DDR06 


DB 


DDR14 


DB 


DDR14A 


DB 


DDR16 


DB 


DDR 19 


DB 


DDR28 


DB 


ERPIBSET 


BJ 


ER2311 


BF 


FILEON 


DC 


GETRQE 


DC 


GETTCB 


DC 


lEAOABOO 


AA 


IEA0DS02 


BC 


lEAOEFOO 


BF 


lEAOPTOl 


BC 


lECINT 


00 


lECINT 


BA 


lECINTRP 


CB 



Routine 

System-Initiated DDR Routine 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
Channel Check Handler 
DDR Tape Reposition Routine 
DDR Tape Reposition Routine 
DDR Tape Reposition Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
System-Initiated DDR Routine 
Channel Check Handler 
Error Routine Interface 
DDR Tape Resposition Routine 
DDR Tape Reposition Routine 
DDR Tape Reposition Routine^ 
EXCP Validity Check Routine 
I/O Interruption Supervisor 
Error Routine Interface 
I/O Interruption Supervisor 
I/O Supervisor Overall Flow 
I/O Interruption Supervisor 
I/O Error Recovery Routines 
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Symbol 



Chart 



Routine 



lECXCPER 


00 


lECXCPER 


CA 


lEEBAl 


AL 


IGCOOO 


AA 


IGC015 


CA 


IGC2503D 


DC 


IGE0025C 


CB 


IGE0025D 


CB 


IGE0025F 


CB 


IGE0525F 


CB 


TGFCAT 


BT 


IGFCCH35 


BK 


IGFCCH48 


BK 


IGFCCH60 


BK 


IGFCCH68 


BK 


IGFCCH70 


BK 


IGFCCH80 


BK 


IGX00015 




INTAPROl 


EA 


INT API 


EA 


INTAP7 


EA 


INT APS 


EA 


INTAP9 


EA 


INTAPIO 


EA 


INTAP12 


EA 


INTAP12A 


EA 


INTAP13 


EA 


INTAP16 


EA 


INTATT 


BE 


INTATT2 


AL 


INTATT2 


BE 


INTCCH 


BA 


INTCSn 


00 


INTCSn 


BD 


INTCSn 


BM 


INTCSn 


BN 


INTCSn 


BO 


INTCIC 


BM 


INTCIC 


BN 


INTERR 


BE 


INTERR3 


BE 


INTERR4 


BE 


INTER7 


BE 


INTER? C 


00 


INTER? C 


CA 


INTERS 


00 


INTERS 


CA 


INTER9 


CA 


INTRREL 


BP 


INTRRELl 


BP 


INTRROO 


BG 



I/O Supervisor Overall Flow 

Error EXCP Routine 

Post Start I/O Routine 

EXCP Validity Check Routine 

Error EXCP Routine 

DDR Tape Reposition Routine 

I/O Error Recovery Routines 

I/O Error Recovery Routines 

I/O Error Recovery Routines 

I/O Error Recovery Routines 

Channel Check Handler 

135 Channel Analysis Routine 

155 Channel Analysis Routine 

2860 Channel Analysis Routine 

145 Channel Analysis Routine 

2S?0 Channel Analysis Routine 

2880 Channel Analysis Routine 

Extended SVC Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

Alternate Path Retry Routine 

I/O Interruption Supervisor 

Post Start I/O Routine 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

Channel Search Routine, No Alternate Paths 

Channel Search Routine, Alternate Paths 

Channel Search Routine, Channels With No 

Direct Access Devices Requiring Seeks 

Channel Search Routine, No Alternate Paths 

Channel Search Routine, Alternate Paths 

Error Routine Interface 

Error Routine Interface 

Error Routine Interface 

Error Routine Interface 

I/O Supervisor Overall Flow 

Error EXCP Routine 

I/O Supervisor Overall Flow 

Error EXCP Routine 

Error EXCP Routine 

Channel Search Routine 

Channel Search Routine 

Sense Subroutine 
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Symbol 



Chart 



Routine 



INTSEN 


00 


INTSEN 


BE 


INTSEN 


BG 


INTSOl 


BG 


INTS02 


BH 


INTS02A 


BH 


INTS02B 


BH 


INTS02D 


BG 


INTS02G 


BH 


INTS02H 


BH 


INTS03 


BG 


INTS03A 


BG 


INTS04 


BG 


INTS04 


BH 


INTS05 


BL 


INITIO 


BH 


INTTRAP 


BB 


INTVMSA 


BC 


INT002A 


BA 


INT003 


00 


INT003 


BA 


INT005 


00 


INT005 


BB 


INT006 


BA 


INT008 


BB 


INT009 


BE 


INTO] A 


00 


INTO 1 A 


BA 


INT07A 


BC 


INTO 10 


00 


INTO 10 


BB 


INTOIOA 


00 


INTOIOA 


BB 


INTO 11 


BE 


INTO 1 IB 


00 


INTOllB 


BE 


INTO 12 


BB 


INT12C 


BB 


INTO 13 


00 


INT013 


BE 


INTO 14 


BA 


INTO 14 


BB 


INTO 19 


BB 


INT019B 


00 


INT019B 


CA 


INT022 


BE 


INT023 


00 


INT023 


BC 


INT024 


00 


INT024 


BC 



I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Sense Subroutine 

Teleprocessing and Shared DASD Post 

Sense Processing 

Sense Subroutine 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

Error EXCP Routine 

Error Routine Interface 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 

I/O Supervisor Overall Flow 

I/O Interruption Supervisor 
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Chart 



INT024B 


BC 


1NT025 


BC 


INT025A 


00 


INT025A 


BC 


INT025B 


BC 


INT027 


BC 


INT031 


00 


INT031 


AF 


INT031 


BE 


INT031B 


00 


INT031B 


BF 


INT031B 


BH 


INT031B 


BM 


INT031B 


BN 


INT031B 


BO 


INT033 


00 


INT033 


BD 


INT033C 


BD 


INT034 


BM 


INT034 


BN 


INT034 


BO 


1NT034A 


BM 


INT034A 


BN 


INT034A 


BO 


INT034C 


BM 


INT034C 


BN 


INT034C 


BO 


INT034D 


BM 


INT034D 


BN 


INT034D 


BO 


INT034G 


AB 


INT034G 


BM 


INT034G 


BN 


INT034G 


BO 


INT036 


BM 


INT036 


BN 


INT036C 


BM 


INT036C 


BN 



Routine 

I/O Interruption Supervisor 
I/O Interruption Supervisor 
I/O Supervisor Overall Flow 
I/O Interruption Supervisor 
I/O Interruption Supervisor 
I/O Interruption Supervisor 

l/vJ kjupcivisvji v^vciaii riuw 

Start I/O Routine for Direct- 
Access Devices 
I/O Interruption Supervisor 
I/O Supervisor Overall Flow 
Hrror Routine Interface 
Sense Subroutine 
Channel Search Routine, No 
Alternate Paths 

Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct Access Devices Requiring Seeks 
I/O Supervisor Overall Flow 
I/O Interruption Supervisor 
I/O Interruption Supervisor 
Channel Search Routine, No Alternate Paths 
Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct-Access Devices Requiring Seeks 
Channel Search Routine, No Alternate 
Paths 

Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct-Access Devices Requiring Seeks 
Channel Search Routine, No Alternate 

rillll!) 

Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct-Access Devices Requiring Seeks 
Channel Search Routine, No Alternate 
Paths 

Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct-Access Devices Requiring Seeks 
Get Request Element Routine 
Channel Search Routine, No Alternate 
Paths 

Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct-Access Devices Requiring Seeks 
Channel Search Routine, No Alternate Paths 
Channel Search Routine, Alternate Paths 
Channel Search Routine, No Alternate Paths 
Channel Search Routine, Alternate Paths 



Section 4: Directories 173 



Symbol 


Chart 


INT038 


BM 


INT038 


BN 


INT038 


BO 


INT038B 


BM 


INT038B 


BN 


INT038B 


BO 


INT050A 


BF 


INT055 


BE 


INT057 


BF 


INT058 


BF 


INT059 


BF 


INT12B 


00 


INT12B 


BC 


INT12C 


AF 


INT17A 


BC 


lOTAPE 


DC 


NSLREPOS 


DC 


OPDDR03 


DA 


OPDDR05 


DA 


OPDDR15 


DA 


OPDDR15A 


DA 


OPDDR17 


DA 


OPDDR18A 


DA 


OPDDR18B 


DA 


OPDDR21 


DA 


OPDDR22 


DA 


PRGCOMA 


BC 


PRGCOMB 


BC 


PROCDMSG 


DC 


PURGECHK 


DB 


SERROl 


AL 


SERR04 


AL 


SERR04 


BA 


SERR04 


BH 


SWAPMSG 


DC 


TRACE 


AK 


UCBSCH 


BI 


VALCHK 


AA 


VALCHK2 


AA 


VERIFYON 


DC 


WTORWAIT 


DB 


XCPCH 


AC 


XCPPDQ 


AA 


XCPPDQ 


AB 


XCPPDQ 


AF 


XCPPDQ 


AK 



Routine 

Channel Search Routine, No Alternate 
Paths 

Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct-Access Devices Requiring Seeks 
Channel Search Routine, No Alternate 
Paths 

Channel Search Routine, Alternate Paths 
Channel Search Routine, Channels With No 
Direct-Access Devices Requiring Seeks 
Error Routine Interface 
Error Routine Interface 
Error Routine Interface 
Error Routine Interface 
Error Routine Interface 
I/O Supervisor Overall Flow 
I/O Interruption Supervisor 
Start I/O Routine for Direct- 
Access Devices 
I/O Interruption Supervisor 
DDR Tape Reposition Routine 
DDR Tape Reposition Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
Operator-Initiated DDR Routine 
I/O Interruption Supervisor 
I/O Interruption Supervisor 
DDR Tape Reposition Routine 
System-Initiated DDR Routine 
Post Start I/O Routine 
Post Start I/O Routine 
I/O Interruption Supervisor 
Sense Subroutine 
DDR Tape Reposition Routine 
Start I/O Subroutine 
Channel Check Handler 
I/O Interruption Supervisor 
EXCP Validity Check Routine 
DDR Tape Reposition Routine 
System-Initiated DDR Routine 
Test Channel Routines 
EXCP Validity Check Routine 
Get Request Element Routine 
Start I/O Routine for Direct-Access Devices 
Start I/O Subroutine 
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Routine 



XCPPDQ 


AL 


XCPPDQ 


BK 


XCPPDQ 


BM 


XCPPDQ 


BN 


XCPPDQ 


BO 


XCPPIO 


AL 


XCPPI02 


00 


XCPPI02 


AL 


XCPPI04 


AL 


XCPPNO 


00 


XCPPNQ 


AB 


XCPPNQB 


BC 


XCPPNQB 


BF 


XCPPNQB 


CA 


XCPPST 


BC 


XCPRR007 


AG 


XCPR008B 


AG 


XCPSIO 


AD 


XCPSIO 


AE 


XCPSIO 


AK 


XCPTCH 


00 


XCPTCH 


AC 


XCPTCH3 


AC 


XCPTST 


00 


XCPTST 


AB 


XCPTST2 


AB 


XCPOIOA 


00 


XCPOIOA 


AB 


XCPOll 


AB 


XCP020 


AB 


XCP021 


BD 


XCP03E 


AG 


XCP052 


AL 


XCP054 


AK 


XCP054A 


AK 


XCP056C 


AL 


XCP056E 


00 


XCP056E 


AL 


XCP060 


AA 


XCP061C 


AA 


XCP064 


AA 


XCP064 


BC 


XCP070 


AB 


XCP072 


AB 


XCPllO 


AK 


XCPllOB 


AK 


XCPllOC 


00 


XCPllOC 


AK 



Post Start I/O Routine 

Sense Subrouline 

Channel Search Routine, No Alternate 

Paths 

Channel Search Routine, Alternate Paths 

Channel Search Routine, Channels With No 

Direct— Access Devices P^equiring Seeks 

Post Start I/O Routine 

I/O Supervisor Overall Flow 

Post Start I/O Routine 

Post Start I/O Routine 

I/O Supervisor Overaii Flow 

Get Request Element Routine 

I/O Interruption Supervisor 

Error Routine Interface 

Error EXCP Routine 

I/O Interruption Supervisor 

Start I/O Routine for Direct-Access Devices 

Start I/O Routine for Direct-Access Devices 

Start I/O Routine for Unit Record and 

Communications Devices 

Start I/O Routine for Magnetic-Tape Devices 

Start I/O Subroutine 

I/O Supervisor Overall Flow 

Test Channel Routines 

Test Channel Routines 

I/O Supervisor Overall Flow 

Get Request Element Routine 

Get Request Element Routine 

I/O Supervisor Overall Flow 

Get Request Element Routine 

Get Request Element Routine 

Get Request Element Routine 

I/O Interruption Supervisor 

Start I/O Routine for Direct-Access Devices 

Post Start I/O Routine 

Start I/O Subroutine 

Start I/O Subroutine 

Post Start I/O Routine 

I/O Supervisor Overall Flow 

Post Start I/O Routine 

EXCP Vahdity Check Routine 

EXCP Vahdity Check Routine 

EXCP Vahdity Check Routine 

I/O Interruption Supervisor 

Get Request Element Routine 

Get Request Element Routine 

Start I/O Subroutine 

Start I/O Subroutine 

I/O Supervisor Overall Flow 

Start I/O Subroutine 
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AK 
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Routine 

Start I/O Routine for Direct-Access 
Devices 

Start I/O Subroutine 
I/O Supervisor Overall Flow 
Start I/O Subroutine 
Start I/O Subroutine 
Start I/O Routine for Unit-Record and 
Communications Devices 
Start I/O Routine for Unit-Record and 
Communications Devices 
Start I/O Routine for Unit-Record and 
Communications Devices 
Start I/O Routine for Magnetic- 
Tape Devices 

Start I/O Routine for Magnetic- 
Tape Devices 

Start I/O Routine for Magnetic- 
Tape Devices 

Start I/O Routine for Direct- 
Access Devices 
Start I/O Routine for Direct- 
Access Devices 
Start I/O Routine for Direct- 
Access Devices 
Start I/O Routine for Direct- 
Access Devices 
Start I/O Routine for Direct- 
Access Devices 
I/O Supervisor Overall Flow 
EXCP Validity Check Routine 
Start I/O Routine for Direct-Access 
Devices 

Start I/O Routine for Direct-Access 
Devices 

Start I/O Routine for Magnetic-Tape 
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Start I/O Routine for Magnetic-Tape 
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Communications Devices 
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Data Area Relationships 



The major paths by which I/O supervisor routines can reach specific data areas are 
shown in Figure 13. The longer paths are seldom used, because pointers to major data 
areas are normally maintained in registers. For example lOBREG, which is register 2, 
will normally contain the address of the input/output block (lOB) for a request in 
process. One exception is the Purge routine, which must use the longer paths in 
locating and removing elements from queues. 



Data Area Layouts 



This section contains descriptions of the principal data areas used by routines of the 
I/O supervisor. 

In some cases major portions of the block, not relevant to the functions of the I/O 
supervisor, are omitted. In those cases, a reference is made to a publication where a 
more complete description can be found. 

Some of the data areas (for example, the CAW, CSW, and the PSW) are fully 
described in the publications IBM System/ 360 Principles of Operation, 
GA22-6821, and IBM System/ 3 70 Principles of Operation, GA22-7000. The 
descriptions of those data areas in this section are therefore condensed. They are 
meant to minimize, but not to eliminate, references to those publications. 

The symbolic names shown in individual data area fields represent the offset, in bytes, 
from the beginning of a table to the field. Access is gained to a specific field by using 
an instruction in which the beginning address of the table (usually contained in a 
register) is the base address, and the symbolic field name represents the displacement. 

There are places where the symbolic field names will differ from names used in other 
publications. Names used here were taken from I/O supervisor Ustings, and where 
differences exist, a non-I/O supervisor program may refer to the field by the other 
name. (To resolve name differences, compare offsets; if the offsets match, the names 
represent the same field.) 

Usage of the data area fields can be traced in the I/O supervisor listings by first 
locating the symbolic field names in the cross-reference table at the back of the listings 
and then noting where the names are used. Where no symbolic name appears in a data 
area field, the field is most likely not referred to by the I/O supervisor. 

The page format used for data area field description is identical to that used in the 
publication OS System Control Blocks, GC28-6628. The field headings and their 
meanings are: 

Bytes and Field 
Offset Alignment Name Field Description, Contents, Meaning 

Offset — The numeric address of the field relative to the beginning of the data area. 

The first number is the offset in decimal, followed (in parentheses) by the 
hexadecimal equivalent. 

Example: 
16 (10) 
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Unit Control Block 



Unit Control Blodk 



Logical Channel Word 




Request Queue Element 



Request Queue Ele 



^ 



Unit Control Block 



Request Queue Element 




Figure 13. Data Area Relationships 
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Channel Address Word 



Channel Command Word($) 
(lOS Channel Program) 



Channel Command Words(si 
(Reifwc>iOf'iCliuiiiie! rrogram;| 



©- 



(MVT Only) 

There is no significance to the 
number of data oreos shown in 
this figure. 

For additional information, see 
the descriptions of the individual 
data areas in Section 5- 





Input/Output Block 


/ 




Event Control Block 




\ 


\ 






\ 






Data Extent Block 




Data Control Block 




v 


;-^ 




^^' 


\ 






Unit Control Block 


\ 


Task Control Block 














Task Control Block 




1st lOB in Purge Chain 





Date Area Nome 


Offset 


Field Nome 


Content 


Data Extent Block 


1(1) 


DEBTCBAD 


f Task Control Block 




17(11) 


DEBUSRPG 


t First lOB in Purge Choin 




25(19) 


DEBDCBAD 


t Dota Control Block 




33(21) 


DEBUCBAD 


t Unit Control Block 


Input/Output Block 


5(5) 


lOBECB 


* Event Control Block 




17(11) 


lOBST 


t Requestor's Chonnel Program 




21(15) 


lOBDCB 


♦ Data Control Block 


Logical Chonnel Word 


0(0) 


LCHFTS 


^ First RQE in Logicol Channel Queue 




2(2) 


LCHLTS 


t Lost RQE in Logical Channel Queue 


Request Queue Element 


0(0) 


TSTLNK 


♦ Next RQE in Logical Channel Queue 




2(2) 


TSTUCB 


t Unit Control Block 




5(5) 


TSTIOB 


» Input/Output Block 




9(9) 


TSTDEB 


t Dota Extent Block 




15(0F) 


TSTTCB 


t Task Control Block (MVT only) 


Unit Control Block 


10(A) 


UCBLCI 


Value which, when multiplied by 8, 
becomes an index to the logical 
chonnel word for the logical channel 
containing the device. 



Figure 13. Data Area Relationships 
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Bytes and Alignment — The size (number of bytes) of the field and its alignment 
relative to the fullword boundary. 



Examples: 

4 . . . 
. . 2 . 
... I 
... 3 



A 4-byte field beginning on a word boundary. 
A 2-byte field beginning on a halfword boundary. 
A 1-byte field in the low-order byte of a word. 
A 3-byte field beginning at the low-order byte of a word 
(and running into the next word). 



Field Name — A name that identifies the field. 

This column is also used to show the bit settings of flag fields; that is, the state of 
bits in a byte. When the column is used to show the state of bits (0, 1), in a flag 
byte, it is shown as follows: 

The 8 bit positions (0 - 7) in a byte. For ease of scanning, the 

high-order (left-hand) 4 bits are separated from the low-order 
4 bits. 

X A reference to bit 0. 

1 Bit is on. 

Bit is off. 

XX A reference to bits 6 and 7. 

Bit settings that are significant are shown and described. Bit settings that are not 
presently significant are described as reserved bits. Do not use these bits because 
the Operating System may make use of them in the future. 

Field Description, Contents, Meaning — The use of the field. 

Where a field's contents relate directly to a value coded by the user (generally in 
job control statements) the value coded is shown under the heading: 

Code — The value coded by the user that resulted in the described contents. 



Alternate Path Table 



The alternate path table (Figure 14) contains a record of the paths by which a device 
can be reached. There is one alternate path table for each logical channel that contains 
more than one channel. In the listings, an alternate path table immediately precedes 
the Test Channel routine for its associated channel. 



Two to Four Fullword 
Entries, Depending Upon 
Number of Alternate 
Paths, 



1 

Channel Address 


T' — 

Path Number 
1 


1 

II II 

1 


II II 
1 


1 
1 


II II 
1 


II 1 H 


1 

II II 


1 

No. of Paths 

1 


1 

Sum of Path Numbers 
1 



} 



Control Entry. 



Figure 14. Alternate Path Table 
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Channel Address Word 



The channel address word (Figure 15) is referred to by a channel during execution of a 
Start I/O instruction. It is the means by which the channel can determine the main 
storage location from which it should fetch the first channel command word (CCW). 
The channel address word is permanently assigned to main storage location 72. 



CAWLOC 



0(0) 
Protection 



(1) 



Bits: 



Figure 15. Channel Address Word 



CHANNEL ADDRESS WORD 





Bytes and 


Field 


Offset 


Alignment 


Name 


0(0) 


1 


CAWLOC 



1(1) 



. 3 



Field Description, Contents, Meaning 

Protection Key. In systems having the data set 
protection feature, contains the requestor's 
protection key. Otherwise, contains zeros. 

The main-storage address of the first 
CCW to be executed. 



Channel Availability Table 



The channel availability table (Figure 16) exists only in those systems where the 
M65MP option has been selected. There is one channel availabiUty table for each of 
the two CPUs, located in the prefixed storage area for that CPU. The table contains 






iiiiig 11 a v^iiaiiiici KJi Liic uiiici ^^r LJ 15 avaiiciuic. 



For convenience, other data areas located adjacent to the channel availability table in 
the prefixed storage area are also shown and described. 

CHANNEL AVAILABILITY TABLE AND ADJACENT DATA AREAS 



Offset 

0(0) 



4(4) 



Bytes and Field 
Alignment Name 



Field Description, Contents, Meaning 

Address of the M65MP extension to the 
communication vector table. 



CHANO Channel flags. Second byte not used. 

1 Channel busy. Set to 1 by EXCP supervisor 

following SIO. Set to by interruption supervisor 
after channel end. 

.1 Channel not operational. Set to 1 by the nucleus 

initialization program (NIP) if the channel 
responds "not operational" (cc=3) to test channel 
instruction. This flag is also set to 1 following 
a Vary Channel command placing the channel offline. 
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0(0) 




Address of M65MP Extension 
to Communication Vector Table 




4(4) 


CHANO 
Channel Flags 




6(6) 


CHANl 
Channel 1 Flags 


8(8) 


CHAN2 
Channel 2 Flags 




10(A) 


CHANS 
Channel 3 Flags 


12(C) 


CHAN4 
Channel 4 Flags 




14(E) 


CHANS 
Channel 5 Flags 


16(10) 


CHAN6 
Channel 6 Flags 




18(12) 


Reserved 


20(14) 




Address of Other CPU's PSA 




24(18) 




lOCPUID 
CPU Identifier 




28(1C) 




29(1 D) 






CPUID 

CPU Identifier 






Reserved 




32(20) 




STMASK 
Shoulder Tap Mask 




36(24) 




Reserved 





Channel 

Availability 

Table 



Figure 16. Channel Availability Table and Adjacent Data Areas 



Bytes and Field 
Offset Alignment Name 

..1 

...1 ... 



.... X... 

XXX 

6(6) . 2 CHANl 

8(8) 2 CHAN2 

10(A) . 2 CHAN3 

12(C) 2 CHAN4 

14(E) . 2 CHANS 

16(10) 2 CHAN6 



Field Description, Contents, Meaning 

Channel not in system. Set to 1 by NIP if the 
channel is not included in system generation. 
Channel not available. Assembled as a 1, and set to 
by NIP following a Test Channel response indicating 
availability. This flag is also set to 1 after a Vary 
CPU command placing the channel's CPU offUne. 
Not used. 
The physical channel address, from through 6. 

Channel 1 flags. Same as channel flags. 

Channel 2 flags. Same as channel flags. 

Channel 3 flags. Same as channel flags. 

Channel 4 flags. Same as channel flags. 

Channel 5 flags. Same as channel flags. 

Channel 6 flags. Same as channel flags. 
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Offset 



Bytes and 
Alignment 



Field 
Name 



Field Description, Contents, Meaning 



Df^cf^rx 



20(14) 4 
24(18) 4 



28(1C) 1 

29(1D) . 3 
32(20) 4 



Address of the other CPU's prefixed storage area 
(PSA). 

lOCPUID CPU identifier. Set by NIP to X'OOOOOOOO' for 

CPU A and X'OOOOOOOS' for CPU B. Used by EXCP 
supervisor to set bit 4 of the M65MP flags in 
the UCB following SIO. The interruption 
supervisor uses this field to test the UCB flags 
following an interruption. If the setting does 
not match, the interruption is identified as the 
second of two device ends presented when a device 
changes status from "not ready" to "ready". Some 
control units present one device end for this 
change to each attached channel. 

CPUID CPU identifier. An identifier set by NIP to X'Cl' 

(EBCDIC'A') for CPU A and to X'C2' (EBCDIC'B') 
for CPU B. 

Reserved. 

STMASK Shoulder tap mask. Bit settings in the shoulder 

tap mask are tested by the receiving CPU following 
a shoulder tap to see what actions are requested. 
In each case the performing CPU resets the flag 
to when the action is completed. 

Bit A Write Direct instruction has already been 

issued, but not accepted by the other CPU. 
Additional bits may be set on without issuing 
another Write Direct instruction. 

Bit 16 A Quiesce command is pending. 
Bit 1 7 A Vary CPU command is pending. 
Bits 24-31 Start I/O requested. (X'Ol') 

Channel Command Word 

The channel command word (CCW, Figure 17) indicates to a channel what I/O 
operation it should start. For operations involving data transfer, the CCW also 
indicates the main storage location into which data is to be placed or read from, and 
how many bytes of data are to be transferred. 
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0(0) 

Command 
Code 


1(1) 


Data Address 




Bits: 


7 8 




31 




4(4) 

Flags 


^^B 


6(6) 


Count 




Bits: 

Figure 


32 39 40 47 48 

17. Channel Command Word 




63 



CHANNEL COMMAND WORD 



Offset 

0(0) 



Bytes and Field 
Alignment Name 



1 



1(1) .3 



4(4) 1 



6(6) . . 2 



Field Description, Contents, Meaning 

Command code. Specifies the operation to be 
performed. 

Data address. Specifies the main storage location 
of a data area. Depending upon the command code, 
data is either read from or placed into the data 
area during an I/O operation involving data transfer. 

10 Chain-Data (CD) flag. The data area designated by 

the next CCW is to be used*with the current 
operation. 

01 Chain-Command (CC) flag. The operation specified 

by the command code of the next CCW is to be initi- 
ated on normal completion of the current operation. 

..1 Suppress-Length-Indication (SLI) flag. The 

incorrect length status bit in the channel status 
word is not to be set by the channel if it detects 
an incorrect-length condition. 

...1 .... Skip flag. Data transfer to main storage is to be 
suppressed. This flag is vaUd only for read, read 
backward, and sense operations. 

.... 1... Program controlled interruption (PCI) flag. The 

channel is to cause an interruption when this CCW 
is executed. 

000 Must be zeros for every CCW except for those CCWs 

specifying a transfer in channel operation. 

Count. Specifies the number of bytes in the data 
area associated with this CCW. 



Channel Error Block Table 

The channel error block table (Figure 18) is used by the optional alternate path retry 
routines. It contains entries (Figure 19) used to keep track of the failing paths to a 
device. (Alternate path retry routines remove failing paths from contention so that 
retries are only attempted on remaining non-failing paths.) 
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CEBTAB 




Entry 1 


Entry 2 


Entry 3 


Entry 4 


Entr" 5 



> 



Piaiirp 1 8 Chanre' Prrnr Rlnrk" Tahlp 



0(0) 



CEBINA 
Active Inactive 
Indicator 



1(1) 
CEBCHM5K 
Failing Patli Mask 



2(2) 



CEBRQE 
Address of RQE 
for Failing Request 



Figure 19. Channel Error Block Table Entry 



Offset 

0(0) 



1(1) 

2(2) 
Channel Status Word 



CHANNEL ERROR BLOCK TABLE ENTRY 



Bytes and Field 
Alignment Name 



1 



CEBINA 



Field Description, Contents, Meaning 

Active /inactive indicator: 
Meaning 



Content 
(Hex.) 
01 



FE 



Used only in the first CEB. 
Indicates there is at least one 
active CEB in the CEB table. 
This CEB is active. 



. . 2 



CEBCHMSK 



CEBRQE 



Failing path mask. Zeros indicate faiUng 
paths. 

Address of RQE for the failing request. 



The channel status word (CSW, Figure 20) indicates to a program the status of an I/O 
device, control unit, channel, and subchannel. The CSW is assigned permanently to 
main storage location 64. Information is stored in the CSW by a channel after an I/O 
interruption, and also during execution of the Start I/O, Test I/O, and Halt I/O 
instructions. 
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CSWLOC 
3 


4 


7 


8 










31 


0(0) 

Protection 
Key 


0000 


1(1) 


Address of Last CCV 


'^8 






32 




47 48 






63 


4(4) 


Status 




6(6) 




Count 





Figure 20. Channel Status Word (CSW) 



Offset 



Bytes and 
Alignment 



0(0) 1 



1(1) 



4(4) 



6(6) 



CHANNEL STATUS WORD 



Field 
Name 



Field Description, Contents, Meaning 



xxxx .... Protection Key. In systems having the data set 
protection feature, contains the requestor's 
protection key. Otherwise, contains zeros. 

.... 0000 Always zeros. 



A main-storage address which is eight higher 
than the address of the last executed CCW. 



Status Byte 1 



1. 



1... 
.1.. 
..1. 
...1 



Attention. 
Status modifier. 
Control unit end. 
Busy. 

Channel end 
Device end. 
Unit check. 
Unit exception. 



Status Byte 2 

1 Program-controlled interruption. 

.1 Incorrect length. 

..1 Program check. 

...1 .... Protection check. 

.... 1... Channel data check. 

1.. Channel control check. 

1. Interface control check. 

1 Chaining check. 

Count. The number of bytes of data that 
remained to be transferred after the last CCW 
was executed. 
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Channel Table 



The channel table is composed of entries containing addresses of Channel Search 
routines, arranged in channel number order (Figure 21). It is used when a channel 
becomes free and a channel-dependent Channel Search routine is needed to select 
requests that should be started next. The format of a channel table entry is shown in 
Figure 22. 



lECCST 



Entry for Byte Multiplexor Channel 



Entry for Selector Channel 1 



entry ror jeiecror \-nannei ^ 



Entry for Selector Channel 6 



Figure 21. Channel Table 



0(0) 

Address of Channel Search Routine 


2(2) 

Channel 
Mask 


3(3) 

Reserved 



Figure 22. Channel Table Entry 



Bytes and Field 
Offset Alignment Name 

0(0) 2 
2(2) 1 



CHANNEL TABLE ENTRY 



Field Description, Contents, Meaning 

Address of the Channel Search routines for the 
channel represented by this entry 



1000 0000 
0100 0000 
0010 0000 
0001 0000 
0000 1000 
0000 0100 
0000 0010 
0000 0001 



Channel mask 
Channel 
Channel 1 
Channel 2 
Channel 3 
Channel 4 
Channel 5 
Channel 6 
Channel 7 
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Data Control Block 



Data control blocks (DCBs) describe the current use of a data set. For every data set 
to be processed by a program, there is a corresponding DCB. 

Although they are maintained primarily by data management routines, DCBs do 
contain a limited amount of information maintained or referred to by the I/O 
supervisor (Figure 23). 



0(0) 






DCBRELAD 

Address of SER Parameter Table 

Partitioned Data Set Member Name 




12(C) 






DCBBLK 
Block Count 




44(2C) 


DCBFL 
Flags 


45(2D) 


DCBDEB 
Address of DEB 



If Chonnel 
Check Handler 
Included with 
System 



Magnetic 
Tope 
Devices 
Only 



The symbolic names of fields in this control block may not agree with names used in other publications. 
For additional information, see the explanation at the beginning of the Data Area Layouts section. 

Figure 23. Data Control Block Fields Used by the I/O Supervisor 



DATA CONTROL BLOCK 



Offset 

0(0) 



Bytes and 
Alignment 



Field 
Name 

DCBRELAD 



12(C) 4 



DCBBLK 



Field Description, Contents, Meanii^ 

If the system has the Channel Check Handler, 
contains the address of a 12-byte parameter 
list. In MFT systems, the list is in control 
section lEAAIHOO; in MVT systems it is in 
control section lEAQFXOO. 

If the system does not have the Channel Check 
Handler, contains the address of a partitioned 
data set member currently being used. 

A count of the number of blocks read from or 
v^ritten onto magnetic tape. After a successful 
I/O operation, this value is increased by an 
increment provided by the requestor in his lOB. 
The addition takes place in the tape trapcode 
routine. 
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Offset 



Bytes and Field 
Alignment Name 



44(2C) 1 



DCBFL 



00.. 




01.. 




11.. 




..10 


.... 


..01 






00.. 




11.. 




01.. 




10.. 




..XX 



45 (2D) 
Data Extent Block 



DCBDEB 



Field Description, Contents, Meaning 

Used in communicating error conditions to a 

requestor and in determining corrective 

procedures. 

Not in error procedure. 

Error correction in process. 

Permanent error condition. 

Channel 9 printer carriage tape punch sensed. 

Channel 12 printer carriage tape punch sensed. 

Always use 1/ kj supervisor error routine. 

Never use I/O supervisor error routine. 

Never use I/O supervisor error routine. 

Never use I/O supervisor error routine. 

Reserved. 

Address of data extent block for the data set. 



The data extent block (DEB) contains an extension of information in the data control 
block (DCB). Every DEB is associated with a DCB, and the two point to each other. 
The DEB contains information concerning the physical characteristics of a data set. 

Each DEB (Figure 24) consists of one 32-byte base plus: 

• One 4-byte extension if the data set is to be processed on unit-record or 
magnetic-tape devices 

• One 16-byte extension for each extent if the data set is to be processed on a 
direct-access device 

There are special forms of DEBs that are not described here. A complete description is 
contained in the publication OS System Control Blocks, GC28-6628. 



LH\ 1 J\ I1,A 1 11,1'^ 1 DLiW^^A. 





Bytes 


and 


Field 


Offset 


Alignment 


Name 


0(0) 


1 




DEBNMSUB 


|l(l) 


. 3 




DEBTCBAD 


4(4) 


1 




DEBAMLNG 


5(5) 


. 3 




DEBDEBAD 


8(8) 


1 




DEBOFLGS 



Field Description, Contents, Meaning 

Number of subroutines loaded by the open 
executor routines. 

Address of requestor's TCB. 



DEBAMLNG Number of bytes in the access method dependent 
section. For BDAM this field contains the 
length expressed in number of words. 

Address of next DEB for the same task. 



01.. 
10.. 
11.. 
..1. . 
...1 . 



Data set status flags. 

Disposition is OLD. 

Disposition is MOD. 

Disposition is NEW. 

EOV or EOF. 

Release unused external storage. 
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0(0) 

DEBNMSUB 

No. of Subroutines 


1(1) 

DEBTCBAD 
Address of TCB 


4(4) 

DEBAMLNG 
Length of Access 
Method Section 


5(5) 

DEBDEBAD 

Address of Next DEB 


8(8) 

DEBOFLGS 

Data Set Status Flags 


9(9) 

DEBIRBAD 
Address of IRB 


12(C) 

DEBOPATB 
Type of I/O 


13(D) 

DEBQSCNT 

Purge Quiesce Count 


14(E) 

DEBFLGSl 
A Flag Field 


16(10) 

DEBNMEXT 
No. of Extents 


17(11) 

DEBUSRPG 

Address of First lOB in User Purge Chain 


20(14) 

DEBPRIOR 
Priority 


21(15) 

DEBECBAD 

Address of Routine Parameter List 


24(18) 1 

DEBPROTG/'DEBDEBID 
Protection ' DEB 
Key 1 Identification 


25(19) 

DEBDCBAD 
Address of DCB 


28(1 C) 

DEBEXSCL 
Extent Scale 


29(1 D) 

DEBAPPAD 

Address of I/O Appendage Vector Table 



2 All Devices 



32(20) 


33(21) 




DEBDVMOD 




DEBUCBAD 


Set Mode Command Code 




Address of UCB 


(Mag. Tape Devices Only) 







} 



Unit Record 
and Magnetic 
Tape Devices 



Note 1 



0(0) 

DEBDVMOD 
File Mask 


1(1) 

DEBUCBAD 
Address of UCB 


4(4) 

DEBBINUM 
Bin Number 


6(6) 

DEBSTRCC 

Address of First Cylinder in Extent 


8(8) 

DEBSTRHH 
Address of First Read/Write Head in Extent 


10(A) 

DEBENDCC 

Address of Last Cylinder in Extent 


DEBENDHH 
Address of Last Read/Write Head in Extent 


''*(^) DEBNMTRK 

No. of Tracks Allocated in 
This Extent 



Direct 

Access 

Devices 

Extent 

Entry 



Note 1: The offsets shown are measured from the beginning of the extent entry. The first extent entry always begins at offset 32(20) 
from the beginning of the data extent block. 



Figure 24. Data Extent Block (DEB) Fields Used by the I/O Supervisor 
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Offset 


Bytes and 
Alignment 


Field 
Name 

.... 1... 

1.. 

1. 

1 


9(9) 


. 3 


DEBIRBAD 


12(C) 


1 


DEBOPATB 



13(D) 



14(E) . . 2 

16(10) 1 

17(11) .3 

20(14) 1 

21(15) .3 

24(18) 1 



25(19) . 3 
28(1C) 1 



Field Description, Contents, Meaning 

DCB modification. 

Split cylinder. 

Nonstandard labels. 

Use reduced error recovery procedure 

(magnetic-tape devices only). 

Address of IRB used for appendage 
asynchronous exits. 

The method of input/output processing 
and the disposition that is to be performed 
when an end-of-volume condition occurs. 






(always zero) 


.1 


(MVT only) Set by ABEND to indicate 




SYSABEND or SYSUDUMP data set. 


..01.... 


REREAD 


..11.... 


LEAVE 


.... 0000 


INPUT 


.... nil 


OUTPUT 


.... 0011 


INOUT 


.... 0111 


OUTIN 


.... 0001 


RDBACK 


.... 0100 


UPDAT 


DEBQSCNT 


Purge quiesce count. When Purge 



DEBFLGSl 
DEBNMEXT 

DEBUSRPG 

DEBPRIOR 
DEBECBAD 

DEBPROTG, 
DEBDEBID 

xxxx .... 

.... nil 

DEBDCBAD 
DEBEXSCL 



(SVC 16) is issued with the quiesce function, 
this field contains the count of the active 
devices associated with the data extent block. 

A flag field. 

Number of extents. The number of direct- 
access device extent entries in this DEB. 

The address of the first lOB in the user 
purge chain. 

The priority of the requestor's task. 

The address of a parameter list used to locate 
PURGE ECB of an SVC purge quiesce request. 



Requestor's protection key. 
Identifies this block as a DEB. 

Address of DCB associated with this DEB. 

Extent scale: 4 for direct-access devices, 2 
for nondirect-access and communications 
devices. Used in determining the size of the 
device-dependent section of this DEB. 
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Bytes and 


Field 


Offset 


Alignment 


Name 


29(1D) 


. 3 


DEBAPPAD 


32(20) 


1 


DEBDVMOD 

00 

01 

10 

..10 1... 

..11 1... 


33(21) 




DEBUCBAD 



Field Description, Contents, Meaning 

Address of I/O appendage vector table. 

Operation code of Set Mode command 

(magnetic-tape devices only.) 

200 BPI 

556 BPI 

800 BPI 

Even parity 

Odd parity 

Address of UCB for device associated 
with tliis data set. 

DIRECT-ACCESS STORAGE DEVICES 

EXTENT DESCRIPTION SEGMENTS: For each extent there is one 16-byte 
segment as follows: 

0(0) 1 DEBDVMOD* File mask for Set File Mask command. The file 

mask describes the Write and Seek commands 
that can be performed in a CCW chain. 

1 (1) .3 DEBUCBAD* Address of the UCB for the device associated 

with this data set. 

4(4) 2 DEBBINUM The cell number for an IBM 2321 Data Cell 

Drive. Zero for all other devices. 

6(6) . . 2 DEBSTRCC The starting cylinder number on all devices 

except the IBM 2321 Data Cell Drive. For the 
2321, contains the starting subcell and 
strip number. 

8(8) 2 DEBSTRHH The starting read/write head number on all 

devices except the IBM 2321 Data Cell Drive. 
For the 2321, contains the starting cylinder 
number and read/write head number. 

10(A) . . 2 DEBENDCC The ending cylinder number on all devices 

except the IBM 2321 Data Cell Drive. For the 
2321, contains the ending subcell and strip 
number. 

12(C) 2 DEBENDHH The ending read/ write head number on all 

devices except the IBM 2321 Data Cell Drive. 
For the 2321, contains the ending cylinder 
number and read/write head number. 

14(E) . . 2 DEBNMTRK The number of tracks allocated in this extent. 

*Access to these fields is gained via the beginning of the DEB. Access to the 
remaining fields is via the beginning of the direct section of the DEB. 
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Device Statistics Table 



The device statistics table contains counters that are used to keep track of the number 
of times error conditions have occurred on I/O devices. 

There is one 10-byte entry in the device statistics table for each I/O device in a 
system; in addition, there is a 10-byte control field at the beginning of the table which 
is used in locatinp entries to be undated (Figure 25). 

In the case of the 3400 tape devices, a 20-byte statistics table entry is allocated for 
each device in a system. 

There are four general formats of device statistics table entries (Figure 26). Bytes 
through 7 of every entry contain as many four-bit counters as are needed to keep the 
relevant statistics for the device. Bytes 8 and 9 of each entry are work areas into 
which error routines place bit patterns indicating which counters are to be incremented. 



t UCB256 



+ UCB512 



+ UCB 768 



Reserved 



Entry for UCB 1 



Entry for UCB 2 



Entry for UCB 3 



Entry for UCBi; 



Control 
Field 



Figure 25. Device Statistics Table 



Unit Record Devices 



0(0) I 
Temporary Temporary 
Read Write 
Failures i Failures 


1(1) 


1 

Bus-Out 
Check 

1 


2(2) 1 

Equipment 
Check 

1 


Overrun 


3(3) 
Device 
Dependent 
(Sense Byte 6) 


1 
Device 
Dependent 

1 (Sense Byte 7) 


4(4) 


5(5) 


6(6) 


7(7) 


8(8) 

Work Area 


9(9) 


Work Area 











2400/3400 Series Magnetic Tape Devices 



0(0) 1 
Temporary Temporary 
Read Write 
Failures Failures 


1(1) 1 

Intervention Bus-Out 
Required Check 


2(2) 1 
Equipment Overrun 


3(3) 1 

Ward Data 
Count Converter 
Zero . Check 


4(4) 
Read/Write Longitudinal 
Vert. Red. Redundancy 
Check Check 


5(5) 

Cyclic 
Skew Redundancy 
Check 


6(6J 
Skew Reg. , 

Vert. Red. Noise 
Check 


^'''^ Read 1 Channel 
Opposite 1 Data 
Recovery j Check 


8(8) 

Work Area 


9(9) 

Work Area 







Figure 26 (Part 1 of 2). Device Statistics Table Entries 
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Devices Attached to 2820 Control Units 



0(0) 1 
Temporary Temporary 
Read Write 
Failures i Failures 


1(1) 


1 

Bus-Out 
Check 

1 


2(2) 1 
Equipment 
Check 


3(3) 1 
Track 
Condition 
Check 1 


4(4) 

Track 
Overrun 


5(5) 


No 

Record 

Found 

1 


7{7) 


8(8) 

Work Area 


9(9) 


Work Area 


Devices 


Attached to 2841 Control Units 



0(0) 1 
Temporary Temporary 
Read Write 
Failures Failures 


1(1) 1 

Bus-Out 
Check 


2(2) 1 

Ctr^" Overrun 


3(3) 1 

1^''°<-'^ Seek 
Condition Check 
Check 


4(4) 

Unsafe 

1 


5(5) 

1- . 1. / Control 
Seriahzer/ .. . 

Deserializer ^^ Line 


6(6) 

Arithmetic 

Logical 

Unit 


7(7). . 
Missing 
Address 
Marker 

1 


8(8) 

Work Area 


9(9) 

Work Area 


3410 Series Magnetic Tape Devices 



0(0) 


1(1) 

Noise 
1,0 


2(2) 

VRC 
3,0 


3(3) 

MTE/LRCR 
3,1 


4(4) 

EDC/CRC 
3,3 


5(5) 

Envelope Check 
3,4 


6(6) 1 

Overrun Skew 
0,5 3,2 


7(7) 1 

Spare Spore 
3,7 4,3 


8(8) 

PE 

ID 

CH 

5,3 


Mask Bit 
Expansion 

1 1 1 1 1 


P 


'(') Track In Error 
Mask Bits 
2,0-7 
0|1|2|3 4|5|6|7 


10(A) 

Write TM Parity 
Check Compare 
5,2 5,4 


11(B) 

Toch False 
Check End Mark 
5,5 5,6 


'2(C) 1 Feed- 
Spare Through 

Check 
8,0 8,1 


'3(D) End 

Spore Velocity 
Check 
8,2 8,3 


'^'^W Stort 

Readback Velocity 
Data Check 
8,4 1 8,5 


15(F) 

Marginal 
Spare Velocity 

8,6 8,7 


16(10) 
Not Used Not Used 

9,0 1 9,1 


17(11) 

Not Used Not Used 

9,2 1 9,3 


18(12) 

Backward 

3,6 


19(13) Tape Unit 
Bus Out Positioning 
Check Check 
0,2 1 4,0 



3420 Series Magnetic Tape Devices 



0(0) 



1(1) 



Noise 
1,0 



2(2) 



Read Write VRC 
3,0 



3(3) 



MTE/LRCR 
3,1 



4(4) 



5(5) 



EDC/CRC 
3,3 



Envelope Check /VRC 
3^4 



6(6) 

Overrun 
0,5 



7(7) 



Ske 



Write 
C-Compore Trigger VRC 



Al. 



A7_ 



A3_ 



8(8) 

PE 

ID 

CH 

5^ 



Mask Bit 
Expansion 



J L 



9(9) Track in Error 
Mask Bits 
2,0-7 

0| 1 I 2| 3 I 4 I 5 I 6 |7 



10(A) 
Write TM 
Check 

5,2 



Start Read 
Check 

5.4 



11(B) 

Partial Record Excessive Post 
Amble or TM 



5,5 



5,6 



12(C) 

IBG Drop Feed-Through 

While Writing Check 

8,0 I 8,1 



'3(D) F I o . 

Early Begin 

, Read Back 

^^'^ Check 



8,2 



8,3 



14(E) 

Early Begin 
Read Back 
Check 

8,4 



Slow Begin 
Read Back 
Check 

I 8,5 



15(F) 
Slow End 
Read Back 
Check 
8,6 



Velocity Retry 

I hi 



16(10) 

Not Used 
9,0 



Vel . Change' 
During Write 

9,1 



17(11) 



18(12) 



Not Used 
9,3 



Backward 
3,6 



19(13) 
Bus Out 
Check 

0,2 



ALV Hardware 
Error 

4,0 



Figure 26 (Part 2 of 2). Device Statistics Table Entries 
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Device Table 



Note: The sense byte and bit corresponding to each error counter and mask is 
indicated, (for example, 1,0 = Sense Byte 1, Bit 0) 



The device table (Figure 27) provides the I/O supervisor with a means for obtaining 
the addresses of certain device — and queuing — option dependent routines. The format 
of a device table entry is shown in Figure 28. 



Priority Queui 


g Entry 


FIFO Queui 


ng Entry 


Priority Queu 


ing Entry 


FIFQ Queui 


ng Entry 


Priority Queu 


ing Entry 


FIFO Queui 


ng Entry 


Ordered Seek Q 


ueuing Entry 


Priority Queu 


ng Entry 


FIFO Queui 


ng Entry 


Priority Queu 


ng Entry 


FIFO Queui 


ng Entry 


Priority Queui 


ng Entry 


FIFO Queuing Entry 



Unit Record Device 
Entries 



Magnetic Tope Device 
Entries 



Direct Access Device 
Entries 



Telecommunications 
Device Entries 



Graphics Device 
Entries 



Dummy Device 
Entries 



Figure 27. Device Table 



DEVICE TABLE ENTRY 





Byte 


$ ana 


Field 


Offset 


Alignment 


Name 


0(0) 


2 




DVTENQ 


2(2) 


. 2 




DVTSIO 


4(4) 


2 




DVTTRP 


6(6) 


2 




DVTSEN 



Field Description, Contents, Meaning 

The address of the Enqueue routine for the 
queuing option represented by this entry 

The address of the Start I/O routine for 
the device type represented by this entry 

The address of the Trapcode routine for 
the device type represented by this entry 

The address of the sense subroutine to be 
used for the device 
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0(0) 

DVTENQ 

Address of Enqueue Routine 


2(2) 

DVTSIO 

Address of Start I/O Routine 


4(4) 

DVTTRP 

Address of Trapcode Routine 


6(6) 

DVTSEN 

Address of Sense Routine 



Figure 28. Device Table Entry 



Error Recovery Procedure Interface Block 



When there is a malfunction in a channel and the system has the Channel Check 
Handler routine, the failure is not automatically considered to be permanent. The 
Channel Check Handler routine is entered before any I/O error routine is invoked, and 
it produces an error recovery procedure interface block (Figure 29) that contains 
information pertaining to the cause of the channel failure. When the I/O error routine 
is invoked, it can use the error recovery procedure interface block to determine whether 
or not a retry should be attempted. 



0(0) 

Reserved 


1(1) 

Address of Unit Control Block 


4(4) 

IBPRGFGl 
Program Flags 


5(5) 

IBPRGFG2 
Probable Source 
of Error 


6(6) 

IBEXCSWl 
Validity Indicators 


IBEXCSW2 
Termination and 
Sequence Codes 



Figure 29. Error Recovery Procedure Interface Block 



ERROR RECOVERY PROCEDURE INTERFACE BLOCK 



Bytes and Field 
Offset Alignment Name 



0(0) 
1(1) 



1 



4(4) 1 



xxxx xxxx 



IBPRGFGl 

1 

.1 

..1 

...1 .... 

.... X... 

1.. 

1. 

1 



Field Description, Contents, Meaning 

Reserved. 

Address of unit control block (UCB). The 
address of the UCB for the device in use when 
the channel failure occurred. 
Program flags. 

Channel status word (CSW) was stored after 

a Start I/O instruction was executed. 

CSW was stored after an I/O interruption. 

CSW was stored after a Test I/O instruction was 

executed. 

CSW was stored after a Halt I/O instruction was 

executed. 

Reserved. 

Sense data was stored. 

Count in CSW is valid. 

No retry is to be tried under any conditions. 
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Bytes and Field 
Offset Alignment Name Field Description, Contents, Meaning 

5(5) .1 IBFRGFG2 Probable source of error. 

1 CPU error. 

.1 Channel error. 

..1 Storage control unit error. 

...1 .... Storage error. 

1... Control unit error. 
XXX Reserved. 

6(6) . . 1 IBEXCSWl Validity indicators. Invalid fields may contain 

some useful information. However, they should 
not normally be used by T/O error routines. 

1 Interface address is valid. 

.XX Reserved. 

...1 .... Sequence code is valid. 

....1... Unit status is valid. 

1.. Command address is valid. The CSW contains a 

valid command address. 

1. Channel address is valid. 

1 Device address is valid. The device address in 

the I/O old PSW is valid. This bit should not 
be used by I/O error routines. 

7(7) ... 1 IBEXCSW2 Termination and sequence (retry) codes. 

XX Termination code. Specifies the termination 

signals used on the I/O interface after the 

channel detected the error. 

00 Interface disconnect. 

01 Forced ending sequence (Stop). The channel 

responded to Service In with Command Out. 

10 Selective reset. 

11 System reset. A reset will not occur without a 

channel control check or an interface control 

check. 
..XX .... Reserved. 

.... X... I/O error alert. 

.... 1... The indicated unit has signaled the I/O error on 

the I/O interface. The channel performs a 

selective reset and causes an interface control 

check to be set in the CSW. 

XXX Sequence code. Indicates when the channel 

detected the error. Meaningful only for channel 
control checks or interface control checks. 
Not to be used by error routines involved 
with unit checks. 

000 The error occurred during execution of a Test 

I/O instruction. A pending error interruption 
in the channel may have been cleared. 
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Offset 



Bytes and 
Alignment 



Field 
Name 



.001 



.010 



Field Description, Contents, Meaning 

The channel has sent a Command Out signal but 
has not examined the unit status. May indicate 
unpredictable movement on devices with control 
units that start movement at the Command Out 
signal. 

The device accepted the command but no data 
was transferred. Magnetic tape devices do 
not begin tape motion for a write operation until 
the first byte of data has been transferred. 



.011 



100 



.101 



.110 
.111 



Event Control Block 



At least one byte of data was transferred over 
the interface. The command address in the 
CSW is eight bytes higher than the address of 
the command causing the data transfer. In 
general this means device movement may have 
taken place if an Interface Disconnect signal 
was issued. 

The command was not accepted by the control 
unit or a Command Out signal has not been sent 
to the control unit for the command at the 
address eight bytes higher than the address in 
the CSW. No device movement has taken place. 

The command was accepted but data transfer 
may not have taken place. If the termination 
code is 'interface disconnect,' activity can be 
retried on most devices. It cannot be retried 
if the command was a Write command for a 
magnetic-tape device. 

Reserved. 

No other codes apply. 



The event control block (ECB, Figure 30) is used for communication between various 
components of the control program, as well as between processing programs and the 
control program. 



WW 



ECBFL 

Flags and Completion 

Code 



Address of Request Block if in wait state 



The symbolic name of the first field in this control block may not agree with names used in other publications. 
For additional information, see the explanation at the beginning of the Data Area Layouts section. 



Figure 30. Event Control Block (ECB) 
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EVENT CONTROL BLOCK 



Offset 



0(0) 



Bytes and Field 
Alignment Name 



1 



ECBFL 

1 

.1 

.XXX xxxx 

.111 nil 

.100 0001 



.1001000 



,1001011 



1001111 



1(1) 



l*ield Description, Contents, Meaning 

Waiting for an event to occur. 

The event has occurred. 
Hex. Completion Code: 
7F I/O activity completed without error. 
41 I/O activity not completed because a 

permanent error occurred. 
44 The request was intercepted because a 

permanent error occurred the last time the 

device was used. 
48 The request element has been freed 

because the data set has been found to be 

in permanent error. 
4B One of the following critical errors occur- 
red during tape error recovery processing: 

1 ) The CS W command address in the 
lOB is zeros, erroneously 

2) An unexpected Load Point was 
encountered 

4F A direct-access device error recovery 
routine was unable to read the home 
address record or record 0. 

Before event completion, contains the address 
of the requestor's request block. After 
event completion, contains zeros. 



Input/Output Block 



The input/output block (lOB, Figure 31) is the primary means of communication 
between a requestor of an I/O operation and the I/O supervisor. Aii of the 
information passed between the requestor and the I/O supervisor is either contained in 
the lOB, or is pointed to by the lOB. 

Although the I/O supervisor uses lOBs, it neither creates them nor disposes of them; 
lOBs belong to the requestor of an I/O operation. 



INPUT/OUTPUT BLOCK 



Offset 

0(0) 



Jytes and Field 




Alignment Name 


Field Description, Contents, Meaning 


1 lOBFLl 


Flag byte 1 . 


00 


No chaining. 


01 


Command chaining. 


10 


Data chaining. 


11 


Both command and data chaining. 


..1 


Error routine in control. 


...1 .... 


Device is to be repositioned (2400 series 




tape devices only). 




Modifier flag (1052). 



Section 5: Data Areas 201 



0(0) 


1(1) 


2(2) 




lOBFLl 
I/O Flogs 


IOBFL2 
I/O Flags 


lOBSNS 
Sense Doto 




4(4) 


5(5) 




lOBCOD 
Completion Code 


lOBECB 
Address of ECB 




8(8) 

IOBFL3 
I/O Flags 


lOBCSW* 






Seven Low-Order Bytes of Last CSW 


♦Offset from beginning of table is 8; lOBCSW Is Equated to IOBFL3. 




16(10) 


17(11) 




lOBCC 

SIO Condition Code 


lOBST 

Address of Channel Program 




20(14) 


21(15) 




Reserved 


lOBDCB 
Address of DCB 




24(18) 


25(19) 




lOBMDB 
Repos. Modifier 


lOBRST 
Restart Address 




28(1C) 


30(1E) 




lOBBCT 
(Use Varies) 


lOBECT 

No. of Error Retr 


ies 


32(20) 


33(23) 




lOBDAM 

Direct Access Extent 


lOBCCR 






Data Address* 


*For Teleprocessing. These Bytes are Used for Other Purposes by QTAM and BTAM. 





The symbolic names of fields in this control block may not agree with names used in other publications. 
For additional information, see the explanation at the beginning of the Data Area Layouts section. 

Figure 31. Input/Output Block (lOB) Fields Used by the I/O Supervisor 



^ All Devices 



Direct Access and 
Teleprocessing 
Devices Only 



Offset 



1(1) 



Bytes and Field 
Alignment Name 



Field Description, Contents, Meaning 

1... Cyclic redundancy check needed — tape only. 
1.. Exceptional condition. When an error routine 

returns and this bit is on, the error is 

considered permanent. 

1. Not a related I/O request. 

Start. 

1 Restart. 

IOBFL2 Flag byte 2. 

X Not used. 

.1 Sense will not be performed until device is 

free. At device end, device is free and sense 

command will be issued. 
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Offset 



8(8) 



28(1C) 



Bytes and Field 
Alignment Name 

..1. . 
...1 .... 
.... 1... 
1.. 



1 



2(2) 


. .2 


lOBSNS 


4(4) 


1 


lOBCOD 


5(5) 


. 3 


lOBECB 



IOBFL3 



16(10) 


1 


lOBCC 


17(11) 


.3 


lOBST 


20(14) 


1 




21(15) 


. 3 


lOBDCB 


24(18) 


1 


lOBMDB 


25(19) 


. 3 


lOBRST 



lOBBCI 



Page of GY28-66 16-9 
Revised April 30, 1973 
By TNL GN26-8036 



Field Description, Contents, Meaning 

lOB has been purged. Set by SVC or I/O purge 

routine. 

Set by direct-access device error routines when 

no seek is required. 

Set by direct access error routines when alternate 

track is used. 

Set by direct access error routines when updating 

seek address because a cylinder end or file mask 

condition occurred. 

Set by Device End Post trapcode module when 

channel end occurred without device end 

(graphics only). 

Set by QSAM routines when error recovery is 

to be used for 2540 card punch. 

Sense data (device dependent). 

Completion code for the I/O event (see ECB). 

Address of the ECB to be posted upon 
completion of the I/O event. 

Device-dependent flags. See the descriptions of 
I/O error recovery routines for individual 
devices. 

Instruction length code (01 in bits and 1) and con- 
dition code (bits 2 and 3) returned after execution of 
the start I/O instruction. Bits 4-7 are not used. 

Address of the first CCW in the channel 
program to be executed. 

Reserved. 

Address of the DCB needed for this request. 

During error recovery, contains the command 
code for a needed immediate operation. 

Address of the first CCW in the channel 
program to be used for a restart. 

The four-byte field made up of lOBMDB and 
lOBRST combined may also have the 
following meanings: 

After SVC 16 (PURGE) Quiesce, contains the 
address of the next lOB in the purge chain. For 
the last lOB in the chain, it contains ones. 

During I/O supervisor Write-to-Operator 
routine control, contains the track address of a 
defective track. 

QSAM, BSAM, EXCP access methods— Normal 
scheduling: The value used to increment the 
block count in the DCB for magnetic tape. 
Chained scheduling: Zeros. 



Section 5: Data Areas 203 



Offset 


Bytes and 
Alignment 


Field 
Name 


28(1C) 


1 




1 

.1 

..XX XXX. 

1 


30(1E) 


. 2 




lOBECT 


32(20) 


1 




lOBDAM 



33(23) 



lOBCCR 



Field Description, Contents, Meaning 

BTAM flags: 

SAD or ENABLE given by Open routine 

resulted in a permanent I/O error. 

This lOB is being used. 

(Reserved bits). 

Line is under on-line test operation. 

DIRECT-ACCESS DEVICES 

The number of times an I/O operation has been 
retried. 

The number of the DEB extent block for the 
data set to be read or written. (The first 
extent block is number 0, the second 
number 1, etc.) 

The beginning address of a data area on a direct- 
access device: 











Disk and Drmn 


IBM 2321 










Storage Devices 


Data Cell Drive 








Bytes 1-2 


Zeros 


Cell number 








Bytes 3-4 


Cylinder number 


Subcell(3) and 
Strip(4) number 








Bytes 5-6 


Read/write head 
number 


Cylinder number(5), 
and head number(6) 








Byte 7 


Record number 


Record number 


LCHTAB 
lECILCH 

1 Logical Channe 
Table 


7 1 


r 
1 

1 
L 


-ogical Channel | 

1 








ROE 1 1 






^•-^"^ 1 




1 LCH 


IJ^jcC^ 


RQE 1 








^^--^ 






RQE 1 






1 








1 
1 


-ogical Channel 1 
Queue 1 








RQE 1 1 




1 LCH 


^<z^ 


RQE 1 1 






^ 


-^''""^ 1 






RQE 1 1 





I J L^^Z 

Figure 32. Logical Channel Queues 
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Logical Channel Word 



The logical channel word (LCH) is an eight— byte data area wiiich is used primariiy to 
define the bounds of a logical channel queue (Figure 32). There is one logical channel 
word for each logical channel queue. All of the logical channel words together make 
up a table called the logical channel table. The format of a logical channel word is 
shown in Figure 33. 



0(0) 

LCHFTS 

Address of First RQE in Logical 

Channel Queue 


2(2) 

LCHLTS 

Address of Last RQE in Logical 

Charviel Queue 


4(4) 

LCHSRH 
Work Ares 


6(6) 

LCHTCH 

Addreu of Test Channel Routine 



Figure 33. Logical Channel Word (LCH) 



LOGICAL CHANNEL WORD 



Offset 

0(0) 


Bytes and 
Alignment 

2 


Field 
Name 

LCHFTS 


2(2) 


.2 




LCHLTS 


4(4) 
6(6) 


2 
.2 




LCHSRH 
LCHTCH 



Field Description, Contents, Meaning 

Address of the first RQE in the logical channel 
represented by this logical channel word 

Address of the last RQE in the logical channel 
represented by this logical channel word 

Work area 

Address of the Test Channel routine to be used 
for the channels in this logical channel 



Program Status Word 



The program status word (PSW, Figure 34) is a two-way communication link between 
a CPU and a program. All PSWs occupy permanently assigned main-storage locations. 
The PSWs to which the I/O supervisor refers are: 



Name 


Location 


Symbolic Name 


SVC Old PSW 


32 (20) 


SVCOPSW 


I/O Old PSW 


56 (38) 


lOPSWO 


I/O New PSW 


120 (78) 


lONPSW 















0(0) 
System Mask 


1(1) 
Protection Key 


AMWP 


2(2) 


Interruption Code 




Bits: 


7 8 11 12 


15 16 




31 




4(4) 
ILC 


CC 


Program 
Mask 


5(5) 


Instruction Address 






Bits: 3 

Figi 


2 34 36 40 

ire 34. Program Status Word 






63 
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PROGRAM STATUS WORD 



Offset 

0(0) 



Bytes and 
Alignment 

1 



Field 
Name 



.1.. 
..1. 



1(1) 



1(1) 



4 


xxxx .... 


bits 




4 


.... xxxx 


bits 


.... 1... 




.... 0... 




1.. 




0.. 




1. 




0. 




1 








2(2) .2 



4(4) 



XX. 



4(4) 



..XX 



Field Description, Contents, Meaning 

System mask. Each bit represents a potential 
interruption source. A system mask bit of 1 
allows the corresponding source to cause an 
interruption. A mask bit of prevents 
interruptions from occurring; they remain 
pending. 

Channel 0. 

Channel 1. 

Channel 2. 

Channel 3. 

Channel 4. 

Channel 5. 

Channels 6 and up. 

External interruptions (timer, interruption key, 

and external signals of the direct control 

feature). 

Protection key. This key is matched with a 
storage key whenever data is stored in or fetched 
from a location that is protected. 

AMWP bits. Four single-bit indicators: 

ASCII 8-character set. 

EBCDIC character set. 

Machine check interruptions can occur. 

Machine check interruptions will remain pending. 

The CPU is in the wait state. 

The CPU is in the running state. 

The CPU is in the problem state. 

The CPU is in the supervisor state. 

Interruption code. Identifies the cause or source 
of an interruption. For I/O interruptions, 
contains the address of the device that caused 
the interruption. 

Instruction length code (ILC). For program or 
or supervisor call interruptions, contains 
the length, in halfwords, of the last interpreted 
instruction. For I/O, external, and machine-check 
interruptions, the ILC is unpredicatable. 

Condition code (CC). Reflects the results of 
the execution of an instruction. 
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Offset 

4(4) 



Bytes and 
Alignment 



Field 
Name 



xxxx 



1... 
.1.. 
..1. 

...1 



5(5) 



Field Description, Contents, Meaning 

Program mask. Each bit represents a potential 
interruption source. A program mask bit of 1 
allows the source to cause an interruption. A 
mask bit of prevents the interruption from 
occuring. 

Fixed-point overflow. 
Decimal overflow. 
Exponent underflow. 
Significance. 

Instruction address. The leftmost byte of 
the next instruction to be executed. 



Recovery Management Support Communication Area 

The recovery management support communication area (Figure 35) is used by the 
dynamic device reconfiguration routines. It contains the flags by which they monitor 
and control the change of volumes from one device to another, and it also contains the 
addresses of control blocks needed during the I/O operations they perform. 

RECOVERY MANAGEMENT SUPPORT COMMUNICATION AREA 



Offset 

0(0) 

4(4) 



Bytes and 
Alignment 



8(8) 


4 


12(0) 


4 


16(10) 


4 


20(14) 


1 



Field 
Name 

CCHPTTAB 



Field Description, Contents, Meaning 

Address of error recovery procedure interface 
block table. 

Flag indicating if there are any record entries 
to be written. 

Address of inboard record area. 

CCH base register value. 

Address of CCH channel dependent analysis 
routine pointer table. 

2880 channel logout pointer. 



1 

.X 


SYSRES option specified. 
Reserved. 


..1 

...1 .... 
.... 1... 


Request being processed. 
System-initiated requests permitted. 
Validate 'To' device. 


1.. 


Nonstandard labels. 


1. 


Nonstandard label verification routine is 




available. 


1 


Operator-initiated request. 
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0(0) 


Address of ERPIB Table 


4(4) 
Flag 


5(5) 

Address of 1 nboard Record Area 


8(8) 


CCH Base Register Value 


12(0C) 

Address of CCH Channel Pointer Table 


16(10) 


2880 LOGOUT Pointer 


20(14) 
DDRFLGSA 


21(15) 

SYSRESAD 

Address of SYSRES Routine 


24(18) 
DDRFLGSB 


25(19) 

RMSTCB 

Address of DDR TCB 


28(1C) 
DDRFLGSC 


29(1D) 

lOSVT 

Address of DDR Appendage 

Vector Table 


32(20) 
DDRFLGSD 


33(21) 

USRTCB 

Address of Device User's TCB 


36(24) 
CNSLID 
Console ID 


37(25) 

USRDCB 

Address of Device User' s DCB 


40(28) 

DDRFMUC 
Address of 
' From ' De 


B 

UCB for 

^ice 


42 (2A) 

DDRTOUCB 
Address of UCB for 
'To' Device 


44(2C) 

ALTCUASR 

Pointer to Address of Alternate 

SYSRES Device 


48(30) 

USRRQE 
Save Are 
RQE 


3 for User' s 


50(32) 

OURRQE 
Address of DDR 
RQE 


52(34) 

BLKCNT 

Block Count for Magnetic Tape 


56(38) 

FILECNT 

File 

Count 


58(3A) 

DDR 
FLGSE 


59(3B) 

DDRFLGSF 


60(3C) 

DDRECB 

Event Control Block for DDR 

Resident Routine 


64(40) 


lOSECB 

Event Control Block for Return 

from I/O Supervisor 


68(44) 

ALLOCECB 

Event Control Block for Job 

Management Allocation Routine 


72(48) 


ALLOCTCB 
Allocation Save Area 


76(4C) 

REPLYBUF 

Reply Buffer for DDR 

Messages 


80(50) 


COREADOR 

Pointer To Obtained Storage 

For Recording 


84(54) 

ALLOTJID 

TJID Save Area Filled 

by Allocation 


86(56) 

Reserved 


88(58) 


Reserved 


92 (5C) 

DDRCOUNT 

Reserved for DDR SYSRES Routine 


96(60) 






104(68) 


Work 
(28 B 


Area 
^tes) 



Figure 35. Recovery Management Support Communication Area 
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Bytes and 


Field 


Offset 


Alignment 


Name 


21(15) 


. 3 


SYSRESAD 


24(18) 


1 


DDRFLGSB 

1 

.1 

1 

...1 .... 
.... 1... 

1.. 

1. 

1 


25(19) 


. 3 


RMSTCB 


28(1C) 


1 


DDRFLGSC 

1 

.1 

..1 

...1 .... 
.... 1... 

1.. 

1. 

1 


29(1D) 


. 3 


lOSVT 


32(20) 


1 


DDRFLGSD 

1 

.1 

..1 

...1 .... 
.... 1... 

1.. 

1. 

1 


33(21) 


. 3 


USRTCB 


36(24) 


1 


CNSLID 


37(25) 


. 3 


USRDCB 


40(28) 


2 


DDRFMUCB 


42(2A) 


. . 2 


DDRTOUCB 


44(2C) 


4 


ALTCUASR 


48(30) 


2 


USRRQE 


50(32) 


. . 2 


OURRQE 


52(34) 


4 


BLKCNT 



Field Description, Contents, Meaning 

Address of DDR SYSRES routine. 



Issue SWAP message. 

Issue INVALID message. 

lasuc o i oivco vv/\ivji>ii>io messiige. 

Issue DDR TERMINATED message. 

Issue PROCEED message. 

Shared direct access device. 

'To' UCB not found. 

First I/O for control. 

Address of DDR task control block. 



Terminate DDR. 

STAE processing. 

Issue DDR CANCELED message. 

Issue ERROR message. 

Swap UCB information. 

Reposition tape. 

Re-EXCP without control. 

Issue ERP IN PROCESS message. 

Address of lOS-DDR vector table. 



Branch to DDR SYSRES routine. 

Issue message IGF511A if this bit is off 

and the bit indicating branch to DDR SYSRES 

is on. 

Dump tape. 

Read a record. 

Standard labeled tape. 

Unlabeled tape. 

Forward space file. 

Re-EXCP with control. 

Address of device user's TCB. 

Save area for Console Identification. 

Address of Device User's DCB. 

Address of UCB for 'From' device. 

Address of UCB for 'To' device. 

Pointer to address of alternate SYSRES device. 

Save area for user's RQE. 

Address of DDR RQE. 

Block count for magnetic tape. 
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Bytes 


and 


Field 




Offset 


Alignment 


Name 


Field Description, Contents, Meaning 


56(38) 


2 




FILECNT 


File count for magnetic tape. 


58(3A) 


. . 1 




DDRFLGSE 

1 

.1 

..1 

...1 .... 
.... 1... 

1.. 

1. 

1 


Retry user. 

Issue WRONG VOLUME message. 

Tape label processing. 

Read 3330 buffer. 

Error was encountered reading 'from' 

3330 buffer. 

Error was encountered reading 'to' 

3330 buffer. 

Record 3330 buffer. 

'To' device buffer was read. 



59(3B) 



60(3C) 
64(40) 

68(44) 





72(48) 


4 


ALLOCTCB 




76(4C) 


4 


REPLYBUF 




80(50) 


4 


COREADDR 




84(54) 


2 


ALLOTJID 




86(56) 


. . 2 


Reserved. 




88(58) 


4 


Reserved. 


92(5C) 


4 


DDRCOUNT 


1 104(68) 


28 




Request Queue E 


lement 







DDRFLGSE 

1 Issue COMPLETE message. 

.1 Abnormal appendage. 

..1 Re-initialize DDR block count. 

...1 .... Error in label processing. 
\... Initialize DDR processing. 
XXX Reserved. 

DDRECB Event control block for DDR Resident routine. 

lOSECB Event control block for return from I/O 

supervisor. 

ALLOCECB Event control block for Job Management 
Allocation routine. 

Allocation save area. 

Reply buffer for DDR messages. 

COREADDR Pointer to obtained storage for recording. 

TJID save area filled by allocation. 



Reserved for DDR SYSRES routine. 
Work area. 



The request queue element (RQE, Figure 36) contains the addresses of the major 
control blocks that are needed to process a request for I/O activity. 

During system generation, a number of RQEs are created to equal the maximum 
number of I/O new operations that can be processed simultaneoulsy by the new 
operating system. Except for the last, each of these unassigned RQEs contains only 
the address of the next RQE; the last RQE contains Is in its address, or link, field. 
The chain of unassigned RQEs is called a freelist. 
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When a request for I/O activity is received by the I/O supervisor, it removes one RQE 
from the freelist, and initiaUzes that RQE with the addresses of control blocks needed 
to process tiic rcQuest. inis is oone lor every rcQuest, regaruiess oi wiietner or not tuc 
I/O activity can be started immediately. 

When a request cannot be started immediately, the RQE is placed into a logical 
channel queue, where it remains until the needed device and a path to the device 
become available and, optionally, until higher-priority requests for the same device and 
path are satisfied. 

During the I/O activity, the address of the RQE is in the UCBLTS field of the UCB. 

An RQE is returned to the freehst when all I/O activity associated with the request it 
represents is completed. 

All of the RQEs are located contiguously in main storage, and are sometimes referred 
to as the request queue element table. The term 'table' is used loosely, however, 
because access is gained to the specific RQEs via pointers, and not via offsets from the 
beginning of the 'table'. 



0(0) 

TSTLNK 

Address of Next RQE 


2(2) 

TSTUCB 
Address of UCB 


4(4) 

TSTTCB Task ID (MFT) 

TSTASSN Assign RQE Byte 

(MVT) 


5(5) 

TSTIOB 
Address of lOB 


8(8) jsTPR 
Priority 
(MFT only) 


9(9) 

TSTDEB 
Address of DEB 


i2roa 

TSTKEY 

Requestor' s Protection 

Key 


13(0D) 

TSTTCB 
Address of TCB 



} 



MVT Only 



Figure 36, Reauest Oueue Element 



0(0) 2 

2(2) . 2 

4(4) 1 

5(5) . 3 



REQUEST QUEUE ELEMENT 



Bytes and Field 
Offset Alignment Name 



Field Description, Contents, Meaning 



TSTLNK The address of the next RQE in the logical channel 
queue or the next RQE in the freelist. Contains Is 
when this is the last RQE in the queue or freelist. 

TSTUCB The address of the unit control block representing 
the device for which activity is desired. 

TSTCB MFT: A unique TCB identifier, taken from the 
requestor's TCB, or ones, if the RQE is available. 

TSTASSN MVT: Contains ones when the RQE is available, 
zeros when the RQE is assigned. 

TSTIOB The address of the input/output block (lOB) to be 
used for this request. 
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Bytes and 


Field 


Offset 


Alignment 


Name 


8(8) 


1 


TSTPR 


9(9) 


. 3 


TSTDEB 


12(0C) 


1 


TSTKEY 


13(0D) 


. 3 


TSTTCB 



Field Description, Contents, Meaning 

MPT: The requestor's priority. 
MVT: Reserved. 

The address of the data extent block (DEB) to be 
used for this request. 

MVT only: The requestor's protection key or zeros 
in systems without the protection feature. 

MVT only: The address of the requestor's task 
control block (TCB). 



SYSLLOGREC Data Set 



Every time there is an equipment malfunction, data pertaining to the failure is collected 
and stored in the SYSLLOGREC data set. The data can then be retrieved for analysis 
by use of a utility program (the IFCEREPO Utility routine, described in the publication 
OS Service Aids, GC28-6719). 

The SYSLLOGREC data set is contained on the system residence device and is 
initiaUzed during system generation. It contains the following: 

• One header record 

• One record entry for every malfunction for which the system has a system 
environment recording facility 

The header record (Figure 37) is used to find existing record entries and to find where 
new record entries are to be written. 

Record entries contain information pertaining to the environment that existed at the 
time an error occurred. There are several types of record entries. Outboard records 
(Figures 38 and 39) describe I/O device failures; Inboard records (Figure 41) 
describe channel failures; miscellaneous data records (Figure 40) describe the error 
environment for buffered log devices and for IBM 2715; and CPU records describe 
CPU malfunctions (see the publication OS M65 Machine-Check Handler Logic, 
GY27-7155). Record entries are not written in any special grouping or order on the 
SYSLLOGREC data set. A new record entry always follows the last entry written. 



SYSLLOGREC DATA SET HEADER RECORD 



Bytes and 
Offset Alignment 

0(0) 2 



2(2) 



6(6) 



. 4 



Field 
Name 

CLASRC 



LOWLIMIT 



UPLIMIT 



Field Description, Contents, Meaning 

Header record identifier. Should contain all 
Is. Otherwise, critical data has been 
destroyed. 

Address of low extent. The track address of 
the first extent of SYSLLOGREC in the form 
CCHH. 

Address of high extent. The track address of the 
last extent of SYSLLOGREC in the form CCHH. 
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0(0) 


2(2) 


inW! !,M!T 




6(6) 

UPLIMIT 


Header Record 
Identifier 


Address of Low Extent 


Address of High 
Extent 


8(8) 

Address of High 
Extent (continued) 


10(A) 
Not 
Used 


11(B) 

RESTART 
Address of Record Entry Area 


16(10) 

Address of Record 
Entry Area (cont'd) 


'^('^^ 5YTSRE^^ 

Remaining Bytes 
on Track 


20(14) 

TRKCAP 
Total Bytes on Track 


Address of Lost 
Record Written 


24(18) 

Address of Last Record Written (continued) 


29(1 D) TRKSPER 
Highest track 
address for any 
cylinder 


31(1F) 

EWMCNT 

Warning 

Count 


32(20) 
Warning 
Count 
(cont'd) 


33(21) 

DEVCODE 

Device 

Code 


3^^(22) EWMTRK 

Early Warning Message 
Track 


38(26) 

EWMSW 

Switch 

Byte 


39(27) 

SFTYBYTS 

Check 

Byte 



Figure 37. SYSl.LOGREC Data Set Header Record 



Offset 

10(A) 
11(B) 



yiesi miu rieiu 
Alignment Name 

. . 1 



. . 7 



20(14) 2 



29(1D) . 2 
31(1F) ..2 



33(21) 



RESTART 



18(12) . . 2 BYTSREM 



TRKCAP 



22(16) . . 7 LASTTR 



TRKSPER 
EWMCNT 



DEVCODE 



Field Description, Contents, Meaning 

Not used. 

Address of record entry area. The track address 
of the start of the recording area of 
SYSl.LOGREC in the form BBCCHHR. 

Remaining bytes on track. The number of bytes 
remaining on the track upon which the last 
record entry was written. 

Total bytes on track. The number of bytes 
which can be written on a track of the device 
containing the SYSl.LOGREC data set. 

Address of the last record written. The track 
address of the last record written on the 
SYSl.LOGREC recording area in the form 
BBCCHHR. 

Highest track address for any cylinder. 

Warning count. The number of bytes remaining 
on the early warning message track of 
SYSl.LOGREC when the 90% full point 
is reached. 

Device Code. A code denoting the type of 
device on which the SYSl.LOGREC data set is 
resident. 



Code 

01 
02 
03 
04 



Device 

2311 
2301 
2303 
2302 



Code 

06 
07 
08 
09 



Device 

2305-1 
2305-11 
2314 
3330 
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Offset 

34(22) . . 4 

38(26) . . 1 

39(27) . . 1 



Bytes and Field 
Alignment Name 



EWMTRK 



EWMSW 

1 

.XXX xxxx 

SFTYBYTS 



Field Description, Contents, Meaning 

Early warning message track. The track address, 
in the form CCHH, on which the 90% full point 
exists. 

Switch byte. 

The 90% full point message has been issued. 

Unassigned. 

Check byte. Contains all Is. It is used to 
check the header record to ensure that it also 
contains all Is. 



0(0) 

CLASRC 

Class/ 

Source 


1(1) 
SYSREL 
System/ 
Release 


2(2) 

SWITCHES 
switches 


6(6) 

RCDCNT 

Record 

Count 


7(7) 

Not 
Used 


8(8) 


DATE 
Date record was made 


12(C) 

TIME 
Time record was made 


16(10) 

Not 
Used 


17(11) 

CPUSER 
CPU Serial Number 


20(14) 

CPUID 
CPU Identifier 


22(16) 

Not 
Used 


24(18) 


JOBID 
Job Identification 




32(20) 


FAILCCW 
Failing CCW 




40(28) 


CSW 
Contents of Channel Status Word (CSW) 




48(30) 
DEVDEPC 
Data 
Count 


49(31) 

SECUA 
Secondary Channel 
and Unit Address 


52(34) 


DEVTYPE 
Device Type 


56(38) 
SDRCNT 
SDR 
Length 


57(39) 

PCUA 
Primary Channel 
and Unit Address 


60(3C) 

lORETRY 
I/O Retries 


62(3E) 

SENSCNT 
Sense Byte Count 


64(40) 


DEVDEP 
Device Dependent Information 
(Variable Length) 




SDRINF 
' Statistical Data Counter Area : 

(Variable Length) 


SENSE 
Sense Data 
(Variable Length) 



Figure 38. SYSl.LOGREC Data Set Outboard Record (Long) 
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SYSl.LOGREC DATA SET OUTBOARD RECORD (LONG) 



RvtAc and Fi^iW 

Offset Alignment Name 



0(0) 



1(1) 



2(2) 



1 



. 1 



. 4 



6(6) 



7(7) ... 1 

8(8) 4 

12(C) 4 

16(10) 1 

17(11) .3 

20(14) 2 

22(16) . . 2 



CLASRC 
..11 xxxx 
xxxx .... 
xxxx ..1. 
xxxx .1.. 

SYSREL 
...X xxxx 
..iX xxxx 
bits 3-7 
0-lF 

SWITCHES 
Byte 0: 

1 



.1 

..1 

.... 1... 

...X .XXX 

Byte 1 

1 

.1 

..1. ... 
...1 ... 
.... 1. 

1 

X. 

X 

Bytes 2-3 
RCDCNT 



DATE 
TIME 



CPUSER 
CPUID 



Field Description, Contents, Meaning 

Class/source. 
Unit Check record. 
GBR. 

r~\ i_j /-Ai-»T-> 

V^UIlVeiLCU \JDIS.. 

TP access method (TCAM). 

System/release. 

OS 

DOS 



Release level 0-3 1 . 
Switches. 

More records follow. 
Last record. 
Time-of-day clock. 
Reserved for future use. 
Time macro used (HHMMSS) 
Unassigned. 

SDR dump (EOD). 

Temporary error. 

Short record. 

MP system. 

CPU B (MB system). 

Volume dismount. 

Reserved. 

Not used. 

Not used. 

Record count. Bits 0-3 contain the sequence 
number of a physical record. Bits 4-7 contain 
the total number of physical records in this 
logical record. 

Not used. 

Date record was made. System date when 
failure occurred. 

Time record was made. System time when 
failure occurred. 

Not used. 

CPU serial number (System/370 only). 

CPU identifier. 

Not used. 
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Bytes 


and 


Field 


Offset 


Alignment 


Name 


24(18) 


8 




JOBID 


32(2) 


8 




FAILCCW 


40(28) 


8 




CSW 



48(30) 1 

49(31) .; 

52(34) 4 

56(38) 1 

57(39) . 



DEVDEPC 



SECUA 



DEVTYPE 



SDRCNT 



PCUA 



60(3C) 


. . 2 


lORETRY 


62(3E) 


... 2 


SENSCNT 


64(40) 


variable 


DEVDEP 



variable SDRINF 



variable SENSE 



Field Description, Contents, Meaning 

Job identification. Name assigned to the 
job being executed at the time of the 
failure. 

Failing CCW. The CCW which was being 
executed at the time of the failure. 

Contents of channel status word (CSW). The 
contents of the CSW which was stored following 
the detection of the I/O failure. 

Data count. The count of doublewords that 
are used in the record for device dependent 
data. 

Secondary channel and unit address. The 
address of the I/O device associated with the 
final retry. 

Device type. The device associated with the 
failure. 

SDR length. The number of bytes in this record 
used to contain the statistical data counter 
information. 

Primary channel and unit address. The addresses 
of the channel and unit being used when the 
failure occurred. If the unit is a model 2314 
or 3330, this field contains physical addresses. 

I/O retries. The number of I/O retries 
attempted for this failure. 

Sense byte count. The length of the sense byte 
field. 

Device-dependent information. Data of 
a device-dependent nature. 

Statistical data counter area. The area which 
contains statistical counter data. 

Sense data. The sense information that was 
obtained as a result of the failure. 



SYSl.LOGREC DATA SET OUTBOARD RECORD (SHORT) 





Bytes and 


Field 




Offset 


Alignment 


Name 


Field Description, Contents, P 


0(0) 


1 


CLASRC 


Class/source. 






..11 xxxx 


Unit check record. 






xxxx .... 


OBR. 






xxxx ..1. 


Converted OBR. 






xxxx .1.. 


TP access method (TCAM). 
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0(0) 

CLASRC 

Class/ 

Source 


1(1) 

SYSREL 
System/ 
Release 


2(2) 

SWITCHES 
switches 


6(6) 

RCDCNT 

Record 

Count 


Nor 
Used 




8(8) 

DATE 
Date record was mode 


12(C) 

TIME 
Time record was made 




16(10) 
Not 
Used 


17(11) 

CPUSER 
CPU Serial Number 


20(14) 

CPUID 
CPU Identifier 


22(16) 

Not 
Used 




24(18) 

DEVTYPE 
Device Type 


28(1 C) 

SDRCNT 

SDR 

Length 


29(1D) 

CUA 
Channel and Unit Address 




32(20) 

SDRINF 
X Statistical Data Counter Area J 

(Variable Length) 



Figure 39. SYSl.LOGREC Data Set Outboard Record (Short) 



SYSl.LOGREC DATA SET OUTBOARD RECORD (SHORT) 





Bytes and 


Field 




Offset 


Alignment 


Name 


Field Descriptio 


1(1) 


. 1 


SYSREL 


System/release 






...X xxxx 


OS. 






..Ix xxxx 


DOS. 






bits 3-7 





0-lF 



Release level 0-3 1 



2(2) 



. 4 



SWITCHES Switches. 



6(6) 



7(7) 



Byte 0: 




1 


More records follow. 





Last record. 




Time— of— day clock. 


..1 


Reserved for future use. 


.... 1... 


Time macro used (HHMMSS) 


...X .XXX 


Unassigned. 


Byte 1: 




1 


SDR dump (EOD). 


.1 


Temporary error. 


..1 


Short record. 


...1 .... 


MP system. 


.... 1... 


CPU B (MP system). 


1.. 


Volume dismount. 


X. 


Reserved. 


X 


Not used. 


Bytes 2-3 


Not used. 


RCDCNT 


Record count. Bits 0-3 contaii 



. 1 



number of a physical record. Bits 4-7 
contain the total number of physical records 
in this logical record. 

Not used. 
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Page of GY28-66 16-9 
Revised April 30, 1973 
By TNL GN26-8036 



Bytes and Field 
Offset Alignment Name 



8(8) 4 

12(C) 4 

16(10) 1 

17(11) .3 

20(14) . 2 

22(16) . . 2 

24(18) 4 

28(1C) 1 

29(1D) . 3 



DATE 
TIME 

CPUSER 
CPUID 

DEVTYPE 
SDRCNT 

CUA 



32(20) variable SDRINF 



Field Description, Contents, Meaning 

Date record was made. System date when 
failure occurred. 

Time record was made. System time when 
failure occurred. 

Not used. 

CPU serial number (System/370 only). 

CPU Identifier. 

Not used. 

Device type. The device associated with 
the failure. 

SDR length. The number of bytes in this 
record used to contain the statistical data 
counter information. 

Channel and unit address. The addresses of the 
channel and unit being used when the failure 
occurred. 

Statistical data counter area. The area 
which contains statistical counter data. 



0(0) 

CLASRC 

Class/ 

Source 


1(1) 

SYSREL 
System/ 
Release 


2(2) 

SWITCHES 
switches 


6(6) 

RCDCNT 

Record 

Count 


7(7) 

Not 
Used 


8(8) 

DATE 
Date record was made 


12(C) 

TIME 
Time record was made 


16(10) 

Not 
Used 


17(11) 

CPUSER 
CPU Serial Number 


20(14) 

CPUID 
CPU Identifier 


22(16) 

Not 
Used 


24(18) 

DEVDEP 
i Device Dependent Information ; 

(Variable Length) 



Figure 40. SYSl.LOGREC Data Set Miscellaneous Data Record 





Bytes and Field 


Offset 


Alignment Name 


0(0) 


1 CLASRC 




1..1 .... 




1..1 ...1 




11 



SYSl.LOGREC DATA SET MISCELLANEOUS DATA RECORD 



Field Description, Contents, Meaning 

Class/source. 

Summary record from SVC 9 1 and 

DDR recorder. 

Miscellaneous data record. 

Converted TPER record. 
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Offset 

1(1) 



Bytes and Field 
Alignment Name 



2(2) 



1 



6(6) 



7(7) ... 1 

8(8) 4 

12(C) 4 



SYSREL 
...X xxxx 
. . 1 X xxxx 
bits 3-7 
0-1 F 

SWITCHES 
Byte 0: 
1... 
0... 



..1. 



1... 

.XXX 



Byte 1 
Byte 2: 

1 

1 

1.. 

.... 1... 
...1 ..1. 
Byte 3 

RCDCNT 



Date 



TIME 



16(10) 


1 




17(11) 


. 3 


CPUSER 


20(14) 


2 


CPUID 


22(16) 


. . 2 




24(18) 


variable 


DEVDEP 



Field Description, Contents, Meaning 

System/release. 

OS 

DOS 



Release level 0-31. 
Switches 

More records follow. 
Last record. 

(Reserved) 

Time macro used (HHMMSS) 

Not used. 

Not used. 

Model 3330. 
Model 2305-2. 
Model 3211. 
Model 2715. 
Model 2305-1. 
Not used. 

Record count. Bits 0-3 contain the sequence 
number of a physical record. Bits 4-7 contain 
the total number of physical records in this 
logical record. 

Not used. 

Date record was made. System date when 
incident occurred. 

Time record was made. System time when 
incident occurred. 

Not used. 

CPU serial number (System/370 only). 

CPU Identifier (System/370 only). 

Not used. 

Device-dependent information. The device- 
dependent data supplied by the error recovery 
procedure for recording. 



Section 5: Data Areas 219 



0(0) 

CLASRC 

Class/ 

Source 


1(1) 

SYSREL 
System/ 
Release 


2(2) 

SWITCHES 
switches 


6(6) 

RCDCNT 

Record 

Count 


7(7) 

Not 
Used 


8(8) 


DATE 
Date record was made 


12(C) 

TIME 
Time record was made 


16(10) 

Not 
Used 


17(11) 

CPUSER 
CPU Serial Number 


20(14) 

CPUID 
CPU Identifier 


22(16) 

MCELLNG 
A/Viximum MCEL Length 


24(18) 


JOBID 
Job Identification 




32(20) 


ACTIO 
Active I/O Units 




48(30) 


CCW 
Failing CCW 




56(38) 


CSWLWB 
Contents of Channel Status Word (CSW) 




64(40) 


ECSW 
ECSW 


68(44) 


DEVTYPE 
Device Type 


72(48) 
CHANID 
Channel 
Identify 


Channel and Unit Address 


76(4C) 

Mult 


MPINFO 
-system Information 


80(50) 


CHNLOG 

Machine Dependent Channel Ljog 

(Variable) 





Figure 41. SYS.LOGREC Data Set Inboard (Channel-Check) Record 



SYSl.LOGREC DATA SET INBOARD (CHANNEL-CHECK) RECORD 



Bytes and Field 
Offset Alignment Name 



0(0) 1 



1(1) . 1 



CLASRC 

.A. xxxx 
xxxx I... 
xxxx L.l 

SYSREL 

...X xxxx 
..Ix xxxx 
bits 3-7 
0-lF 



Field Description, Contents, Meaning 

Class/source. 
Channel-check record. 
SERL 
SERO. 

System/release. 

OS. 

DOS. 

Release level 0-3 1 . 
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Bytes and Field 
Offset Alignment Name 

2(2) . . 4 



Field Description, Contents, Meaning 



6(6) . . 1 

7(7) . . . 1 

8(8) 4 

12(C) 4 

16(10) 1 

17(11) .3 

20(14) 2 

22(16) . . 2 

24(18) 8 

32(20) 16 



SWITCHES 


Switches. 


Byte 0: 




1 


More records follow. 





Last record. 


.1 


Time-of-day clock. 


..1 


(Reserved). 


.... 1... 


Time macro used (HHMMSS). 


...X .XXX 


Not used. 


Byte 1: 




1 


Operator message required. 


.1 


Record incomplete. 


..1 


System terminated. 


...1 .... 


Channel unsupported or failed to log. 


.... 1... 


Illegal channel and unit address. 


1.. 


Portion of data overlayed. 


1. 


ERP in progress. 


X 


Not used. 


Bytes 2-3 


Not used. 


RCDCNT 


Record count. Bits 0-3 contain the s 



DATE 
TIME 

CPUSER 

CPUID 

MCELLNG 

JOBID 

ACTIO 



48(30) 8 



ccw 



number of a physical record. Bits 4-7 
contain the total number of physical records 
in this logical record. 

Not used. 

Date record was made. System date when 
incident occurred. 

Time record was made. System time when 
incident occurred. 

Not used. 

CPU serial number (System/ 3 70 only). 

CPU identifier. 

Maximum MCEL length. Maximum machine 
check extended log length. 

Job identification. Name assigned to the job 
being executed at the time of the failure. 

Active I/O units. A list of addresses of up 
to eight devices on the faiUng channel that were 
found to be busy (Device End outstanding). 
The list may include the address of the 
device associated with the failure. 

Failing CCW. The CCW that was being 
executed at the time of the failure. 
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56(38) 


8 


CSWLWB 


64(40) 


4 


ECSW 


68(44) 


4 


DEVTYPE 


72(48) 


1 


CHANID 


73(49) 


. 3 


CUA 


76(4C) 


4 


MPINFO 
Byte 0: 

XXX 

...1 .... 

X... 

X.. 

XX 



Byte 1 
Bytes 2-3 



80(50) variable CHNLOG 



Contents of channel status word (CSW). The 
contents of the CSW which was stored following 
the detection of the I/O failure. 

ECSW. The contents of the extended channel 
status word. 

Device type. The type of device associated 
with the failure. 

Channel identity. The type of channel 
associated with the failure. 

Channel and unit address. The channel and unit 
address of the I/O device associated with the 
failure. 

Multisystem information. 

Not used. 

Multisystem feature present. 

Identity of failing CPU (0=1, 1=2). 

Not used. 

CPU status: 

00 = normal multisystem (shared status) 

01 = partitioned mode 

10 = 65 mode (shared but reconfigured) 
Not used. 
Byte 2— CPU 1 
Byte 3— CPU 2 

In each byte there is one bit for each of the 
7 possible channels showing online/offline 
status (offline =1). If not in multisystem 
mode, bytes 2 and 3 will contain all zeros. 

Machine-dependent channel log. The channel 
logout associated with the failure which caused 
the channel check. Logout size is model and 
channel dependent. 



Task Control Block 



The task control block (Figure 42) serves as a repositiory for information and pointers 
associated with the task in progress. 
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28(!r) 

TCBPRT 
Protection Key 




30{1E) 

TCBFLG 
Must-Complete Flogs 




32(20) 

TCBFLGS 

Dlspotchability Flogs 
(MVT Only) 




35(23) 

TCBPR 

Dispatching Priority 



112(70) 



TCB Identifier 



16(74) 



TCBTCB 

Address of Next Lower Priority TCE 

(MVT Only) 



The symbolic names of fields in this control block may not agree with names used in other publications. 
For additional information, see the explanation at the beginning of the Data Area Layouts section. 

Figure 42. Task Control Block Fields Used by the I/O Supervisor 



TASK CONTROL BLOCK 



Bytes and Field 
Offset Alignment Name 



Field Description, Contents, Meaning 



28(1C) 1 



30(1E) . . 1 



TCBPRT 



xxxx 0000 The storage protection key for the task presented 
by this TCB. 

TCBFLG MFT: 



.XX. ..X. 

...1 .... 
.... 1... 

L. 



ABEND prohibited for this task (System tasks 

only.) 

(Reserved bits.) 

Task has issued a system-must-complete and set 

all other tasks in the system non-dispatchable. 

Task has issued a step-must-complete and turned 

off all other tasks in the step. 

Dump processing has been initiated in ABEND. 

This task is a member of a time-slice group 

(MFT only). 



TCBFLG MVT: 

1 Operands of the ABEND macro instruction have 

been saved in the TCBCMP field. 

.1 Second job step interval has expired (initiator 

TCB only). 

..1 Job step can cause rollout (job step TCB only). 

...1 .... System must complete. Current task can be 
performed; other tasks in system cannot. 



Section 5: Data Areas 223 



Offset 



Bytes and Field 
Alignment Name 



1... 



.1.. 



..1. 



,1 



Field Description, Contents, Meaning 

Step must complete; other tasks in job step 

cannot be performed. 

SYSABEND data set already open (job step 

TCB only). 

ETXR exit requested by attaching task. 

Task is a member of a time-slice group. 



32(20) 1 



35(23) . . . 1 
112(70) 1 



116(74) 4 



TCBFLGS (If any bit in this byte is 1 , the task is 
nondispatchable. ) 

1 Set by ABDUMP routine. 

.1 Machine check occurred. All tasks except 

current task placed in wait state. 

..1 Supply of I/O request queue elements exhausted. 

...X XX.. (Reserved bits.) 

1. Task set nondispatchable by one CPU to 

prevent any CPU from performing it (Model 65 

multi-processing only). 
1 ABEND routine was entered by this task 

while DCB for SYSABEND data set was being 

opened for another task. 

TCBPR Dispatching priority for this task. 

TCBID MET: 

TCB identifier field. 

MVT: 

Number of resources for which this task 
is enqueued. 

TCBTCB Address of next TCB of lower priority on 
the ready queue. 



UCB Lookup Table 



The unit control block (UCB) lookup table provides a means for the I/O interruption 
supervisor to quickly find the UCB for a device which has caused an I/O interruption. 
By using the channel and device addresses provided in the I/O old PSW, and by 
referring to the UCB lookup table, the I/O interruption supervisor can obtain the 
address of the needed UCB without checking all UCBs. 

The entire UCB lookup table (Figure 43) is created during system generation. At that 
time all entries are calculated on the basis of system channel and device address 
assignments. 

Although the UCB lookup table occupies contiguous main storage locations, it consists 
of three separate sections: a channel index list, a control unit index list, and a device 
address list. Each serves as an index to the next, with the device list containing 
pointers to UCBs (Figure 44). 
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lECULKl 



IECULK2 



\ 



/ Channel Index List 

( l-Byte Entries) 

Thp C^onne! List contoins index vlues th^t "■■'' .-r>i».t.:, 
to the starting address of the entire UCB lookup table. 



\ 



y Control Unit Index List 

( 1-Byte Entries unless more than 248 devices, or more 
than 7 channels, then 2 bytes are used) 

The Control Unit List contains Index values that are 
relative to the starting address of the device list. 



/ 



IECULK3 



/ 



y Device List 

(2-Byte Entries) 

The Device List contains 
the addresses of the UCBs 
in the system. 



Figure 43. UCB Lookup Table 
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lECULKl 



IECULK2 




Control Unit 

List 



Control Unit 
4 Entry 



Beginning Address of Channel List + Channel Address= Address of Entry in Channel List- 
Beginning of Control Unit List + Contents of Channel List Entry ' 

2 

+Control Unit Address = Address of Entry in Control Unit List 

Beginning Address of Device List + 2 (Contents of Control Unit List Entry) 
+ 2 (Device Number)= Address of Entry In Device List 



Device 
List 



IECULK3 




tUCB242 



1. If the channel number is 7 or greater, the contents of the channel list entry is doubled. 

2. If the control unit entry list contains 2-byte entries, the control unit address is multiplied by 2 before it is used. 

Figure 44. UCB Lookup Table Entry Relationships 



Unit Control Block 



There is a unit control block (UCB, Figure 45) for each device attached to the system. 
It describes the characteristics of the device to the I/O supervisor and is used by the 
job scheduler during allocation of the device. 
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-4(-4) 


-3(-3) 




-l(-l) 


UCBMPANX 








Model 65 




Reserved 


M65MP Flags 


Multiprocessing Flags 









} 



Model 65 

Multiprocessing 

Only 



0(0) 

Internal Job 
Identification 


1(1) 

UCBALLC 

Allocation Channel Mask 


2(2) 


UCBID 
Identifier 


3(3) 

SRTESTAT 
Status Byte A 


4(4) 

UCBCHA 
Switches and 
Channel Address 


5(5) 

UCBUA 
Unit Address 


6(6) 


UCBFLl 
Flag Byte 1 


7{7) 

UCBDTI 

Device Table Index 


8(8) 

UCBETI 

Error Routine Key 


9(9) 

UCBSTI 

Statistics Table Index 


10(A) 


UCBLCI 

Logical Channel 
Table Index 


11(B) 

UCBATI 

Attention Table 
Index 


12(C) 

UCBCHM 

Flags and Channel 

Mask 


13(D) 

Unit Name (for 2305 only) or 
Unit Name of Base Exposure 


16(10) 


UCBTYP 

Device Type Code 




20(14) 

UCBLTS 

Address of Last Requ 


sst Element 


22(16) 


UCBSNS 

Sense Information (not used for 2305/3330 

or Tope Units v^lth Extended Sense) 



2 All Devices 



24(18) 



Address of UCB Extension 

for 1285, 1287, and 1288 Optical Readers 



} 



1285, 1287 
and 1288 
Devices Only 



24(18) 



Address of UCB Extension 

for 2495 Tape Cartridge Reader 



} 



2495 Only 



24(1 i 



UCBNBRSN 
Number of Sense 
Bytes 



28(1C) 



25(19) 



UCBSNADR 

Address of Sense Information 



UCBXTADR 

Address of UCB Extension for 1403 and 321 1 Printers 



The Symbolic names of fields in this control block may not agree with names used in other publications. 
For additional information, see the explanation at the beginning of the Data Area Layouts section. 



Figure 45 (Part 1 of 5). Unit Control Block 



Universal 
Character 
Set (UCS) 
Feature 
Only 
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24(]8) 

Additional Sense InformaHon 


26(1 A) 

Use Count 


27(1 B) 


Control Byte 


28(1 C) 


Task Entry Address 






32(20) 


Restart Address 






36(24) 

Device Index 


37(25) 


Buffer Table Address 







24(18) 



Sense Byte Count 



25(19) 



Address of Sense Byte Extension 



, Graphics 
' Devices 



24(18) 






Additional Sense Information 


28(1C) 






Volume Serial Number 




34(22) 

Status Byte B 


35(23) 

Volume Mount Switch 
DCB Count 


36(24) 




Data Set Sequence Count 




38(26) 

Data Set Sequence Number 


40(28) 






Data Set Ser 


iai Number 




46(E) 

Reserved 


48(30) 


Opt 


ons 


49(31) 


Address of Area Containing CCW for 

Opposite Direction Recovery and Volume Statistics Area 



]} 



Magnetic Tape 
Devices with 
Extended Sense 



Magnetic Tape 
Devices without 
Extended Sense 



Magnetic 
y Tape 
Devices 



Figure 45 (Part 2 of 5). Unit Control Block 
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24(18) 

Number of Bytes to 
be Sensed in Hex 


25(19) 

Pointer to the Sense Area 



} 



2305 and 
3330 only 



24(18) 




Additional Sense Information 




28(1 C) 












Volume S 


erial Number 






34(22) 


35(23) 










Status Byte B 


No. 


of DCBs Open 


36(24) 




Relative Address of Volume Table of Contents 




40(28) 




41(29) 


42 (2 A) 






RESERVE Count* 


Device Reservation 
Indicator 


Used to Schedule DAW 




44 (2C) 




45(2D) 






Flags, DAW 


Address of DEB with Ordered Seek Queuing 




48(30) 




UCBSKA 

Address of Last Seek 




56(38) 




57(39) 






No. of Users 


Direct Access ECB Address 




60(3C) 




Address of Error Recovery Work Area Minus 104 Bytes 





*Used by the Shared DASD Option. 

Figure 45 (Part 3 of 5). Unit Control Block 



■ Direct Access 

\. Devices other 

/ than 2305, 2321, 

P and 3330 



Direct Access 
' Devices (Except 
2321 Data Cell 
Drive) 
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2321 ONLY 

24(18) 



Additional Sense Data 



28(1 C) 



Error Routine Work Area A 



40(28) 



Reserved 



42 (2 A) 



UCBRQESV 
Address of RQE 



44(2C) 



UCBFL4 



45(2D) 



UCBORSV 
Address of the DEB 



^,48(30) 



UCBSKA 
Seek Address Last Used 



55(37) 



J 



2321 ONLY 








56(38) DCELBBNR 
Bin Number 


58(3A) DCELSTAB 

Status Byte B 


59(3B) CCELSTAT 

Cell/Bin Status 


'(57) 






60(3C) 

DCEL\ 
Volume Ser 


'OLl 

iai Number 








66(42) DCELJBNR 

Internal Job Numbers 


67(43) DCELDMCT 

No. of DCBs Open 


68(44) DCELVTOC 

Relative Address of VTOC 


71(47) DCELUSER 

Allocated Data Sets 


Cell in Bin 1 


a; 




Cell in Bin 2 




03(6 


7) 






Cell in Bin 3 




119(77) 





Cell in Bin 4 



Cell in Bin 5 



Cell in Bin 6 



Cell in Bin 7 



Cell in Bin 8 



Cell in Bin 9 



135(87) 



151(97) 



167(A7) 



183(B7) 



199(C7) 



215(D7) 



216(D8) 



Address of the Direct Access UCB Extension 



219(D8) 



Figure 45 (Part 4 of 5). Unit Control Block 
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Direct Access UCB Extension: 



Error Recovery Work Area 



+144(90) 



Track Overflow Work Area (Present When Track Overflow Feature Specified for Control Unit) 



T 



1285, 1287, 1288 Optical Reader UCB Extension: 
















0(0) 

Dora Check Count 


1(1) 


Length 




2(2) 


.-qjip.,.cn 
Count 


Q\--l- 


3(3) 


Re.c,v.J 


Count 




4(4) 




Reserved 











2495 Tape 


Cartridge Reader UCB Extension: 




0(0) 




Retry CCW 1 


8(8) 




Retry CCW 2 


16(10) 




Retry CCW 3 


24(18) 




CSW Save Area 



Figure 45 (Part 5 of 5). Unit Control Block 



UNIT CONTROL BLOCK 



Bytes and Field 
Offset Alignment Name 



-4(-4) 1 



Field Description, Contents, Meaning 

Prefix Segment 

UCBMPANX Model 65 multiprocessing flags. 

.X.. .X.. (Reserved bits.) 

1 Device can be reached via an alternate 

control unit. 
...1 .... CPU A is to use an HIO instruction for 

this device. 
..1 CPU B is to use an HIO instruction for 

this device. 
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Bytes and Field 
Offset Alignment Name 



-3(-3) 
-K-l) 



2 
. . 1 



0(0) 1 



1(1) .1 



2(2) . . 1 



Field Description, Contents, Meaning 

0... CPU A last used an SIO instruction for 

this device. 
1... CPU B last used an SIO instruction for 

this device. 

0. CPU B has a path to this device. 

1. CPU B has no path to this device. 

CPU A has a path to this device. 

1 CPU A has no path to this device. 

Bytes 2-3 (Reserved) 

M65MP flags. 
..11 .1.. Three one-bit switches used by extended Vary 

command, (always on exit). 
..1 Device was reserved by NIP (IPLed CPU)., 

Always zero on exit from NIP. 
...1 .... Device was reserved by IEAMP650 (non-IPLed 

CPU). Always zero on exit from NIP. 
1.. Operator replied 'CONTINUE' to message 

IEA120A for device. Always zero on exit 

from NIP. 
1. One-bit switch used by processing modules, 

(always on exit). 

Device online at IPL. 

1 Device offline at IPL. 

Segment Common to All Devices 

Internal job identification, 
xxxx .... Job protection key. Set if the mounted volume 

is to be retained or contain a passed data set. 
00.. Zeros. 
1. Set during device allocation if volume is to be 

demounted and is retained or contains a passed 

data set. Causes job name in demount message. 
1 Set during device allocation if the volume to be 

mounted is to be retained or contain a passed 

data set. 

UCBFL5 Extended sense bytes. 

xxxx .... Reserved. 

.... 1 . . . UCBSN ADR and UCBNBRSN fields contain 

valid information. 
1.. Device may not be allocated. OLTEP 

controls the device. 

1. Device has alternate control unit address. 

1 Device has alternate channel path. 

UCBID UCB identification— X'FF'. 
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Offset 

3(3) 



Bytes and 
Alignment 

. . . 1 



Field 

Name Field Description, Contents, Meaning 

SRTESTAT Status byte A. 

Device is offline. 

1 Device is online. 

.1 Without multiple console support: Device is 

to be changed from online to offline status. 

With multiple console support: Device status 

is to be changed from oneline to offline, or from 

online to online active console. 
..1 The mount status of the volume on this device is 

'reserved'. (See Note A, below.) 
...1 .... UNLOAD operator command addressed to 

this device; the device is not yet unloaded. 
1... Device is allocated. 
1.. The mount status of the volume on this device is 

'permanently resident.' (See Note A, below.) 

This is the system residence device. 

This is the primary console. 

With multiple console support: 

This is an online active console. 
1 One of these: 

Standard labels have been verified for this tape 

volume. 

This is the secondary console. 

Note A: If the mount status of a volume is 
neither 'reserved' nor 'permanently resident,' 
then the volume is removable. 



4(4) 1 



UCBCHA 
1 

.1 



This bit is turned on when a halt I/O (HIO) is 
issued for the device represented by this UCB. 
This bit indicates either (1) that the device was 
busy when lOS a sensettempted to issue a 
command, in which case the command will be 
issued when the device is free, or (2) lOS is 
waiting for ending status from a sense command 
issued to a TP or shared file device. 
UCBDSNS bit. When on, this bit indicates 
that a sense command for this device has been 
delayed due to a channel logout pending 
condition. 

UCBDHIO bit. When on, this bit indicates that 
a halt I/O command for this device has been 
delayed due to a channel logout pending 
condition, 
xxxx These four bits contain the physical channel 
address of the last physical channel used for 
the device represented by this UCB. 
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Bytes and Field 
Offset Alignment Name 



5(5) 
6(6) 



. 1 



UCBUA 
UCBFLl 

1 



..1. 



...1 



..1. 



...1 



7(7) ... 1 UCBDTI 



8(8) 1 



9(9) . 1 



UCBETI 



UCBSTI 



Field Description, Contents, Meaning 

Unit address. 

Flag byte 1 . 

UCBBSY bit. Set with UCBPST to indicate 

successful start I/O operation, or CSW 

stored with non-busy indication. If the 

second condition occurs, the CCH or I/O 

interrupt handler treats request as an 

interruption. Reset at device end time. 

UCBNRY bit. Indicates device is not ready, or 

should not be started. Bit handled by data 

management, scheduler, ERP-WTO routines, 

and DDR. 

UCBPST bit. Request UCBLTS field not yet 

posted. I/O supervisor assumes current RQE 

valid. Set with UCBBSY; cleared at 

channel end. 

UCBITF bit. Indicates an intercept condition; 

error detected on device after last request 

was posted complete. Next request is 

intercepted, and its control blocks used by 

error recovery routine. 

UCBCUB bit. RQE in UCBLTS field associated 

device. No other request may be started 

on this device. Set if start I/O instruction 

results in a device control unit or channel 

busy condition. Cleared before entering start 

I/O module. 

UCBDTR bit. Set for moving arm direct access 

devices to indicate data transfer is in process. 

Always on with UCBASK bit. 

UCBASK bit. Set only for moving arm direct 

devices to indicate that stand-alone seek 

has been started, completed, or not needed 

since it was already properly positioned. 

Set with UCBBSY and UCBPST bits if stand 

alone seek is in progress. 

UCBERR bit. RQE in UCBLTS field associated 

to this device. No other request may be 

started on this device. Set by DDR, DAW, and 

RMS routines. Also set by the I/O supervisor 

upon an EXCP inspect return from resident 

disk error recovery procedure. 

Indexing value, used in locating the device table 
entry for this device type. 

A binary number used by the exit effect or 
routine to complete the 8-byte name of an 
IBM-supplied error routine for this device. 

Value which, when multiplied by 10, becomes an 
index to the statistics table. 
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Offset 


Bytes and 
Alignment 


Field 
Name 


10(A) 


. . 1 




UCBLCI 


11(B) 


... 1 




UCBATI 


12(C) 


1 




UCBCHM 

1 

.1 

..1 



13(D) . 3 

16(10) 4 

20(14) 2 

22(16) . 2 

24(18) 4 

24(18) 4 

24(18) 1 

25(19) 3 



xxxx 

1... 
.1.. 
..1. 
...1 



UCBTYP 

UCBLTS 
UCBSNS 



UCBNBRSN 
UCBSNADR 



Field Description, Contents, Meaning 

Value which, when multiplied by 8, becomes 
an index to the logical channel word for the 
logical channel containing the device. 

Index to the attention table. 

Flags and channel mask. 

SYSIN. 
SYSOUT. 

Assumed that this device will be allocated for a 

pubhc volume request. 

Rewind command has been addressed to this 

magnetic tape device by I/O support. 

I/O supervisor path mask (used where there are 

two or more paths to a device): 

Primary path to the device is inoperative. 

Optional path 1 to the device is inoperative. 

Optional path 2 to the device is inoperative. 

Optional path 3 to the device is inoperative. 

In multiprocessing systems, bits 4 and 5 
represent the paths from CPU A and bits 6 and 
7 represent the paths from CPU B. 

Unit address (EBCDIC). For the 2305 this 
is the unit address of the base UCB. 

Device type. For a description of this field see 
the publication OS System Control Blocks, 
GC28-6628. 

Address of the request element used for the last 
activity on this device. 

Sense information obtained when a sense 
command was executed. 

1285, 1287, and 1288, Optical Reader Segment 

Address of UCB extension for 1285, 1287, 
and 1288 Optical Readers. 

2495 Tape Cartridge Reader Segment 

Address of UCB extension for 2495 Tape 
Cartridge Reader. 

Universal Character Set (UCS) Segment 

Number of sense bytes. 

Address of sense information. 
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Page of GY28-66 16-9 
Revised April 30, 1973 
By TNL GN26-8036 



Bytes and 
Offset Alignment 

28(1C) 4 



24(18) 2 

26(1A) . . 1 

27(1B) . . . 1 

28(1C) 4 

32(20) 4 

36(24) 1 

37(25) . 3 

24(18) 1 

24(18) 4 

25(19) . 3 

28(1C) 6 

34(22) . . 1 



Field 
Name 



Field Description, Contents, Meaning 



35(23) 



UCBXTADR Address of UCB extension for 1403 and 
3211 printers. 

Graphics Devices 

Additional sense information. 

Use count. Number of DCBs that are currently 
open for this device. 

Graphics control byte for attention handling. 

Address of task entry (TE) block. 

Restart address. The last start address. 

Device index. Device or devices on a control 
unit to which buffer sections are assigned. 

Buffer table address. 

Magnetic-Tape Devices 

Number of bytes of sense information (devices 
with extended sense). 

Additional sense information (2400/3400 Series 
Magnetic Tape Devices). 

Address of area containing sense information 
(devices with extended sense). 

Volume serial number. 

Status byte B. Volume status. 

Device sharability: 

Sharable. 

Not sharable. 

Additional volume label processing. 

Private-volume use status. 

Public-volume use status. 

If the multiple console support option is in the 

system, demount or mount messages have been 

issued and the message IDs are at offset 40 

through 45. Data management OPEN routines 

will delete the messages and turn this bit off. 

(Reserved bits). 

Volume mount switch. Shows whether a 
volume has been mounted and the volume 
label is the type specified by the DD 
statement parameter. For more information 
see OS System Control Blocks, GC28-6628. 
DCB Count. Number of DCBs open for 
this volume. 



X... 




0... 




1... 




..1. 




...1 






1.. 
...1 



.X.. .XX. 
X 



.XXX XXXX 
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Page of GY28-66 16-9 
Revised AprU 30, 1973 
By TNL GN26-8036 



Bytes and Field 
Offset Alignment Name 



36(24) 


2 




38(26) 


. . 2 




40(28) 


6 




46(2E) 


. . 2 




48(30) 


1 


XXXX X..X 

00 

01 

110 



49(31) .3 



1 1 1 



..1 .... 
... 1... 

1 

.XX. 



24(18) 


1 




25(19) 


3 




24(18) 


4 




28(1C) 


6 




34(22) 


. . 1 


X 



1 

.XX 

...1 .... 
.... 1... 

1.. 

1. 

1 



Field Description, Contents, Meaning 

Data set sequence count. 

Data set sequence number. 

Before OPEN: Message IDs. See offset 34, 

bit 7. 

After OPEN: Data set serial number. 

(Reserved) 

Tape options. 

No error volume analysis and no error 

statistics by volume. 

Error volume analysis only. 

Error statistics by volume or error volume 
analysis and error statistics by volume. 

Records are to be written on the system 
management facilities data set (SYS I.MAN). 
Error statistics by volume or error volume 
analysis and error statistics by volume. 

Records are to be written on the operator's 

console. 

Error recovery routine is in control. 

End-of-volume condition has resulted in a 

volume statistics record for this volume. 

UnsoUcited device end. 

Reserved. 

Address of area containing CCW for opposite 
direction recovery and volume statistics area. 

2305 Fixed Head Storage and 3330 Disk 
Storage 

Number of extended sense bytes. 

Address of extended sense information. 

Direct-access devices (Except 2321 Data Cell 
Drive) 

Additional sense information. 

Volume serial number. 

Status byte B. Volume status. 

Volume sharability: 

Sharable. 

Non-sharable. 

(Reserved bits.) 

Private-volume use status. 

Public-volume use status. 

Storage-volume use status. 

JOBLIB data set is on this volume. 

Control volume. A catalog data set is on 

this volume. 
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Bytes and Field 
Offset Alignment Name 



35(23) 



. 1 



Field Description, Contents, Meaning 

Number of DCBs open for this volume. 
When shared DASD option is used, the count 
increases by 1 for each RESERVE macro 
issued by the user. Conversely, for each 
DEQ macro issued, the count is reduced by 1. 



36(24) 4 

40(28) 1 
41(29) . 1 



42(2A) . . 2 



44(2C) 1 



45(2D) . 3 



48(30) 8 
56(38) 1 
57(39) . 3 



Relative address of the volume table of 
contents for this volume, in the form TTRO. 

Number of RESERVE macro instructions issued. 

Device reservation indicator. In a system that 
includes the shared DASD option this indicator 
is set equal to the contents of the preceding 
field after a successful execution of a start 
I/O instruction for a direct access storage 
device (DASD). 

Save area for RQE address. Contains the 
address of the request queue element used in 
verifying the volume serial number in the UCB. 

Flags/Count: 

1 The Volume Serial Verification routine has 

issued a mount message. 
.1 The Volume Serial Verification routine is in 

control. 
..1 Indicates a first-time entry to the Volume 

Serial Verification routine for this Volume. 
...1 .... The volume label is on an alternate track. The 

alternate track procedure is in progress. 
1... The volume serial number has been verified by 

the Volume Serial Verification routine. 
XXX A count of the requests for the device 

from the first requestor on the logical channel 

queue for this device. 

Save area for DEB address. Contains the 
address of the data extent block (DEB) for the 
first requestor on the logical channel queue 
for this device. 

Address of last seek. 

Number of current users. 

Direct access event control block (ECB) address. 
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Bytes and 
Offset A%nment 

60(3C) 4 



24(18) 4 

28(1C) 12 

40(28) 2 

42(2A) . . 2 

44(2C) 1 



Field 
Name 



45(2D) . 3 

48(30) 8 

56(38) 2 

+2 . . 1 



UCBRQESV 

UCBFL4 
1 

.1 

..1 

...1 .... 

.... 1... 

XXX 

UCBORSV 
TICRSKA 



Field Description, Contents, Meaning 

Address of a direct access UCB extension. 
The first valid field is at offset 104. 

2321 Data CeU Drive 

Additional sense information. 

Error Routine Work Area 

A work area for the error routine. 

(Reserved.) 

Address of RQE used to verify the volume 
serial number in the UCB. Set from UCBLTS 
after an unsohcited device end interrupt. 

A flag byte. 

A mount request has been issued by the Volume 

Serial Verification routine. 

Volume Serial Verification routine is in control. 

Indicates a first entry of the volume serial 

Verification routine for this volume. 

Volume label is on a alternate track; the 

alternate track procedure is in progress. 

Volume has been verified by the Volume Serial 

Verification routine. 

The number of requests for the device from the 

first user on the queue. 

Address of the DEB for the first user on the 
queue for this device. 

Address for last seek in the form MBBCCHHR.. 



Description of Cell in Bin 
DCELBBNR Bin number. 



DCELSTAB 


Status byte B. Volume status. 


X 


Volume sharabiUty: 





Sharable. 


1 


Not sharable. 


.XX 


(Reserved bits) 


...1 .... 


Private- Volume use status. 


.... 1... 


Public-Volume user status. 


1.. 


Storage- Volume use status. 


1. 


JOBLIB data set is on this volume. 


1 


Control volume. A catalog data set is on this 




volume. 
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Bytes and 
Offset Alignment 



+ 3 



1 



+4 . 6 

+ 10 . . 1 

+ 11 . . . 1 

+ 12 3 

+ 15 . . . 1 

72(48) 16 
88(58) 16 
104(68) 16 
120(78) 16 
136(88) 16 
152(98) 16 
168(A8) 16 
184(B8) 16 
200(C8) 16 
216(D8) 4 



Field 

Name Field Description, Contents, Meaning 

DCELSTAT Cell/bin status. 

1 Bin is online and normal cell is mounted in it. 

Bin is offline or ballast cell is mounted in it. 

.1 (Reserved bits) 

..1 Reserved. Mount status of the cell in this bin. 

...1 .... UNLOAD operator command has been addressed 

to this bin; the bin has not yet been unloaded. 
1... Bin is allocated. 

1.. Permanently resident — the mount status of this 

cell. If the mount status is neither reserved 
nor permanently resident, then it is removable. 

DCEVOLI Volume serial number. 

DCELJBNR Internal job number. 

DCELDMCT Number of data sets opened for this cell. 

DCELVTOC Address of VTOC, in form TTR. 

DCELUSER Number of data sets allocated to this cell. 

End of description of cell in bin 0. 

Description of cell in bin 1 

(same format as description of cell in bin 

Description of cell in bin 2 

(same format as description of cell in bin 

Description of cell in bin 3 

(same format as description of cell in bin 

Description of cell in bin 4 

(same format as description of cell in bin 

Description of cell in bin 5 

(same format as description of cell in bin 

Description of cell in bin 6 

(same format as description of cell in bin 

Description of cell in bin 7 

(same format as description of cell in bin 

Description of cell in bin 8 

(same format as description of cell in bin 

Description of cell in bin 9 

(same format as description of cell in bin 

Address of the direct-access UCB extension. 
First valid field is at offset 104. 
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Volume Statistics Table 



Ihe volume statistics table contains information and statistics pertaining to volumes on 
magnetic-tape devices. It contains one entry (Figure 46) for each magnetic tape device 
in a system. 

The address of each entry is contained in the unit control block for the device 
containing the volume. The entries may or may not be contiguous. 

For 2400 series magnetic tape units the format of each entry varies according to the 
options selected at system generation time. If neither the error volume analysis (EVA) 
nor the error statistics by volume (ESV) options are selected, an entry will consist of 
only the first 8 bytes shown in Figure 46. If only EVA was specified, each entry will 
consist of the first 16 bytes shown. If ESV or both ESV and EVA were specified, the 
length of each entry will be the full 24 bytes. 

I For 3400 series magnetic-tape units, the length of each entry is always 24 bytes. 



0(0) 






CCW for Read-Opposite Recovery 




8(8) 




lO(OA) 


11 (OB) 


12(0C) 


13(0D) 


14(0E) 


Statistics Update 
Mask 


Read Error 
Threshold 


Write Error 
Threshold 


Temporary 

Read 

Errors 


Temporary 

Write 

Errors 


Start I/O 


16(10) 


17(11) 


18(12) 


19(13) 


20(14) 


22(16) 


Permanent 

Read 

Errors 


Permanent 

Write 

Errors 


Noise 
Blocks 


Reserved* 


Erase Gaps 


Cleaner Actions 



I * ' Mode Set' when tape device has extended sense. 



Figure 46. Volume Statistics Table Entry 
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SECTION 6: DIAGNOSTIC AIDS 

General Register Assignments 
System Completion Codes 
Patch Area at lECINT 
Generalized Trace Facility 
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General Register Assignments 



Table 35 shows the general register assignments for the resident parts of the I/O 
supervisor (EXCP Supervisor, I/O Interruption Supervisor, and Error EXCP 
Supervisor). Assignments for other routines can be found in the prologs to the routine 
listings. 



Table 35. 


General Register Assignments 




Register 


Symbol 


Assignment 





REGO 


Temporary storage 


1 


TSTREG 


ROE Address (For assigned but 
not-queued RQE) 


2 


lOBREG 


lOB address 


3 


DEBREG 


DEB address 


4 


DCBREG 


DCB address 


5 


BASREG 


Base register for I/O supervisor 


6 


UAREG 


Channel and unit address 


7 


UCBREG 


UCB address 


8 


LNKRGl 


Linkage register; second base register 
when two-base feature is required. 


9 


ICREG 


Work register 


10 


WKREGl 


Work register 


11 


WKREG2 


Work register 




PRFXREG 


Prefix storage address register 


12 


WKREG3 
LINKRG3 


Spare work/linkage register 


13 


LCHREG 


Logical channel word address 


14 


LNKRG2 


Linkage register 


15 


APBSRG 


Used for calculating addresses of 
appendages to be invoked and used 
as a base register for the 
appendages 



System Completion Codes 



When a task is terminated abnormally, a three-digit system completion code printed in 
the storage dump generally indicates why. The pubUcation OS Messages and Codes, 
GC28-6631, contains a complete list of system completion codes. The meanings of 
the codes produced when abnormal termination results from trouble during 
input/output processing are shown in Table 36. 
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Table 36. System Completion Codes for Input/Output Operations 



Code 


Explanation 


Comments 


OFl 

0F2 
400 


A program interruption occurred during execution of an instruction in 
the I/O interruption handler. The interruption probably occurred 
because an input/output block, data control block, or data extent 
block was modified after the EXCP macro instruction was issued. 
Check to determine whether an access method routine was overlaid 
in the problem program storage area. 

A progrorii interruption occurred during execution of an instruction In a 
type 1 SVC routine. The interruption probably occurred because 
incorrect parameters were passed to the type 1 SVC routine. 

The input/output supervisor found one of the following control blocks 
to be invalid; 

• Input/output block (lOB). 

• Data control block fDCB). 

• Data extent block (DEB). 

• Event control block (ECB). 

Information is placed into the first three blocks from the DD statement, 
the DCB macro instruction, and the macro instruction by which the I/O 
operation was requested. 

The DD statement or the macro instructions may have been specified 
incorrectly. Also, program errors may have caused the control blocks 
to be modified. 


The interruption code field of the program old PSW (at location 28) will 
identify the cause of the interruption. In systems with MET, the PSW Is 
valid only when the first four digits are 0004. 

See comments for code 'OFl ' . Both the EXCP supervisor and the error 
EXCP supervisor are type 1 SVC routines. 

The input 'output supervisor's EXCP Validity Check routine (Chart AA) 
initiated abnormal termination by passing control to the supervisor's 
ABTERM) routine. For a description of how the control blocks are checked, 
see the topic "Validating Input Data" in Section 2. 



Patch Area at lECINT 



At lECINT is a 17-word storage area that can be used for diagnostic work. Since its 
location is not standard, but differs for each system, the service aid program 
IMBMDMAP can be used to determine the true location of the label lECINT in the 
nucleus. 



Generalized Trace Facility 



Table 37 shows the trace entries for the Generalized Trace Facility that are within the 
I/O Supervisor. 



Table 37. Txace Entries for Generalized Trace Facility 



Error 
ID 

5FF0 



5FEE 

2FDF 
5FEF 



Location 

Immediately after an SIO 



I/O interruption without an 
associated UCB 



Registers 

R1 RQE address 

R6 Device address 

RIO SIO condition code 



PCI interruption only 


R7 


UCB address 


All other interruptions with 


R7 


UCB address 


associated UCB 
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Appendix A: Supporting SVC Routines 

Appendix B: Alternate Path Retry 

Appendix C: Channel Check Handler 

Appendix D: Direct-Access Volume Verification 

Appendix E: Dynamic Device Reconfiguration 

Appendix F: Multiprocessing Extensions 

Appendix G: Program Check Recovery Subroutine 

Appendix H: Shared Direct- Access Storage Device 
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AoDendix A: SuDDorting SVC Routines 



The SVC routines described in this appendix are not generally used during normal 
processing of requests for I/O operations. They do, however, provide users v/ith a 
capability for referring to, obtaining, and changing some of the data used in processing 
the I/O requests. 



Purge Routine (SVC 16) 



The Purge routine stops the processing of I/O requests by removing request queue 
elements from queues. Depending upon the options specified in a parameter list which 
is provided as input (Figure 47), the Purge routine can remove request queue elements 
from: 

• A logical channel queue 

• The supervisor's request block queues 

• The supervisor's asynchronous exit queue 

• The DDR wait queue 

The Purge routine can remove the elements representing all requests for a particular 
data set; or it can remove the elements representing all requests for a particular task. 
The method to be used is indicated in the seventh bit of the options field in the 
parameter list. The general flow of control within the Purge routine is shown in Figure 
49. The PURGE macro instruction is described in OS Data Management for System 
Programmers, GC28-6550. 



0(0) 

PRGOPT 
Purge Options 


1(1) 

PRGDEB 

Address of Data Extent Block 


4(4) 

PRGCOD 
Completion Code 


5(5) 

PRGTCB 

Address of Task Control Block 


8(8) 

PRGCTR 
Quiesce Count 


9(9) 

PRGCHN 

Address of First Link in Chain 


12(0C) 

* PRGFLG 
Flags 


13 (OD) 

PRGQPL 

Address of Quiesce I/O Parameter List 



* TSOonly 



Figure 47. Purge Routine Parameter List 



Removing Elements From Logical Channel Queues 



If all requests for a particular data set are to be purged, the Purge routine examines the 
data extent block (DEB) for the data set, and removes all request queue elements from 
the logical channel queue for the device or devices whose unit control block (UCB) 
addresses are contained in the DEB. When an active shared device is allocated with a 
purged request, the UCB's HIO flag is set by the I/O supervisor to issue a RELEASE 
to the device if its UCB reserve count field is zero. 
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When the elements for all requests associated with a particular task are to be purged, 
the Purge routine scans the entire request elements table to locate and remove the 
request queue elements for the task. 



Offset 



Bytes and 
Alignment 



0(0) 1 



1(1) .3 

4(4) 1 

5(5) . 3 

8(8) 1 

9(9) . 3 



PURGE ROUTINE PARAMETER LIST 



Field 
Name 



Field Description, Contents, Meaning 



PRGOPT Purge options. 



0.. 



.0.. .. 


.1.. .. 


..0 

..1 


...0 .... 

...1 .... 

.... 0... 

.... 1... 

0.. 



1. 



0. 

1. 

X 



Purge request queue elements for all entries in 

the data extent block (DEB) chain, starting 

with the DEB whose address is in PRGDEB. 

Purge only the request queue element for the DEB 

whose address is in PRGDEB. 

Do not post the event control blocks for the 

purged request queue elements. 

Post the event control blocks for the purged RQEs. 

(A hex 48 completion code is used.) 

Allow the activity to quiesce. 

Halt the I/O activity. (The effect of the Halt 

I/O instruction is simulated if the operation 

is a seek.) 

Purge all requests. 

Purge only related requests. 

Normal purge. 

Purge TCB Ust. 

Purge the asynchronous exit queue, the request 

block queue, the logical channel queue, and the 

DDR wait queue. 

Purge the logical channel queue and purge the 

asynchronous exit queue removing only RQEs for 

requests in error, and the DDR wait queue. 

Bypass the request blocks. 

Purge by data extent block. 

Purge by task control block. When this bit is on, 

the setting of bit is ignored. 

Not used. 



PRGDEB Address of data extfent block. 

PRGCOD Purge routine completion code. 

PRGTCB Address of task control block. 

PRGCTR Quiesce count. The number of active request 
queue elements for which I/O activity has not 
yet been completed. 

PRGCHN Address of the first Unk in the chain of lOBs 

which are purged. The first link can be located 
in the user's area, or in the DEBUSPRG field of 
the DEB. It will point to the first lOB in 
the chain. The last lOB in the chain will 
contain ones in the low-order byte of the restart 
address (lOBRST) field. 
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Bytes and Field 
Offset Alignment Name 



Field Description, Contents, Meaning 



12(C) 1 


PRGFLG 


Purge flags. 









Purge entry. 




1 


Wait entry. 




.0 


Return before wait. 




.1 


Purge and wait. 




..0 


DEQ before WAIT. 




..1 


No DEQ before WAIT (set before system DEB 
purged). 




...X .... 


Not used. 




.... X... 


Not used: 




X.. 


Not used. 




X. 


Not used. 




X 


Not used. 


1 


3(D) . 3 


PRGQPL 


Address of quiesce I/O parameter list. 












Temporary 
Count 


Reserved 



















lOBCHAINFIELD 






FLAG* 


TCB ADDRESS 


1 




1 
1 






1 




1 

1 




1 








* Field for Last Entry i$ X '8 


> 




F 


igure 48. Quiesce I/O Parameter List 



QUIESCE I/O PARAMETER LIST (TSO Only) 
Bytes and 



Offset 


Alignment 


Field Description 


0(0) 


1 


Temporary count field. 


1(1) 


. 3 


Not used. 


8(8) 


8 


First parameter list entry. 
Byte Description 
Not used. 
1-3 lOB chain field. 
4 QPL flags. 

More entries follow. 

1 Last entry. 

.0 Not a current entry. 

.1 Current entry. 

5-7 Address of TCB to be purged 



Additional parameter list entries may be present. 
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TCB0002A il 




All RQEs 
Checked 




Get Address of IRE 
or 5IRB From TCB, 
Get Address of 
RQE from IRBor 
SIRB 



For Purge by Dato 
Set Option, Motch 
DEB Address in 
RQE Against Input 
DEB Address 



Purge by TCB 
Option, Motch TCB 
for RQE Against 
Infijt TCB 



Remove RQE 
from Queue, 
Return to 
Freelist 



UCBPRG 
VALCHK 



All 
Checked 




DEBPURG 



Using Input DEB 
Address, Get UCB 
Address from 
DEBs Extent 
Field 



Get Address of 
RQE from RQE 
Table 



UCBPRG 
VALCHK 



More Than 
One Ex- 
tent Field 



All RQEs Checked 




Scan When 

TCB for RQE 
Matches Input TCB, 
Remove RQE from 
Queue 



Using Index in 
UCB, Get Address 
of Logical Channel 
Word. Scon 
RQEs in Queue. 
When DEB Address 
in RQE Mqtches 
Input DEB Address, 
Remove RQE from 
Queue. 



Wait for 
Activity to 
Stop 



-® 



CPU Control Will 
Return to the I/O 
Supervisor Until it 
Posts the ECB Being 
Waited Upon. At 
Thot Time, This 
Routine will be 
Re-Entered. 



0~) 

Return to Supervisor 

Figure 49. Purge Routine 



In MVT Systems, TCB Addresses 
ore Matched. In MFT 
Systems, TCB Identifiers are 
Motched. 



DEB - Data Extent Block 

ECB - Event Control Block 

IRB - Interruption Request Block 

RQE - Request Queue Element 

SIRB - System Interruption Request Block 

TCB - Tosk Control Block 

Descriptions of the IRB and SIRB can be 

found in the publicotion 

OS System Control Blocks, GC28-6628 



Removing Elements From tlie Supervisor's Request Block Queues 



To remove elements from a supervisor request block queue, the Purge routine obtains 
the address of the first request block in the queue from the TCB whose address is 
passed as input. When no TCB address is passed, it assumes that the current TCB is 
the input TCB. The Purge routine then scans the entire request block queue. For each 
system interruption request block (SIRB) and interruption request block (IRB) in the 
queue, the Purge routine removes the RQEs containing a DEB address which matches 
the input DEB address (for a purge by data set); or removes the RQEs containing a 
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TCB address which matches the address of the input TCB (for a purge by task in MVT 
systems); or removes the RQEs containing a TCB identifier which matches the TCB 
identifier of the input TCB (for a Durae bv task in MFT systems). 

Descriptions of the SIRB and IRB are contained in the pubUcation OS System Control 
Blocks, GC28-6628. 

Removing Elements From the Supervisor's Asynchronous Exit Queues 

To remove request queue elements from the supervisor's asynchronous exit queue, the 
Purge routine first obtains the address of the queue from the communications vector 
table. It then scans the entire asynchronous exit queue, removing every RQE 
containing a DEB address which matches the input DEB address (for a purge by data 
set); or removing every ROE containing a TCB address which matches the address of 
the input TCB (for a purge by task in MVT systems); or removing every RQE 
containing a TCB identifier which matches the TCB identifier of the input TCB (for a 
purge by task in MFT systems). When a TCB address is not passed as input for a 
purge by task request, the Purge routine uses the current TCB for the matches. 

The communications vector table is described in the pubUcation OS System Control 
Blocks, GC28-6628. 



The lOB Chain 



The Quiesce Option 



The Purge routine Unks the lOBs for purged requests together in a chain beginning at 
the address specified in the third word of the Purge routine parameter Ust (Figure 50). 
A RESTORE macro instruction could then be used to restart the requests. The Purge 
routine does not create an lOB chain when the halt I/O option is specified with the 
purge-by-TCB option. 



When the quiesce option is specified, the Purge routine increments two counters by one 
for each I/O request awaiting completion: 

• A main purge counter in the parameter list 

• A secondary counter in each effected DEB 

Thus, if there is a request to quiesce activity for a specific data set, both counters will 
have a count of one. If there is a request to quiesce the activity on all data sets of a 
task, however, there will be counts in each DEB counter reflecting the number of 
not-yet-completed requests for the data sets, and there will be a total count in the 
main counter. 

Every time the Purge routine increments a counter, it places a pointer to the purge 
parameter Ust into the 'address of purge parameter list' field of the DEB. Also, after it 
has put the total count in the main counter, the Purge routine issues a WAIT macro 
instruction. 
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Purge Routine Parameter List 



User-Specified Location 



0(0) 
PRGOPT 


1(1) 

PRGDEB 


4(4) 
PRGCOD 


5(5) 

PRGTCB 


8(8) 
PRGCTR 


9(9) 

PRGCHN 



The Purge routine places 
the address of the first 
lOB in the chain into 
the user-specified location. 
Thereafter, it chains the 
iOBs by means of a 
field at offset 25 (dec.) 
and uses ones to indicate the 
last lOB of the chain. 





nput/Output Bloc 


k 






25(19) 

lOBRST 



















\ 
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Figure 50. Purge Routine lOB Chain 



When I/O activity has been completed for a request, the I/O interruption supervisor 
will enter its Quiesce Complete subroutine (entry point PRGCOMA or PRGCOMB) if 
it finds an address in the 'address of purge parameter list' field of the DEB for the 
newly completed activity. The Quiesce Complete subroutine decrements both the main 
and secondary counters by one. If a DEB secondary counter is zeroed, the 'address of 
purge parameter Ust' field in the DEB is also zeroed. When the main counter in the 
parameter list is zeroed, indicating the quiesce is complete, the Quiesce Complete 
subroutine posts the purge ECB. If the main counter is not zeroed, the Quiesce 
Complete subroutine returns control to the I/O interruption supervisor. 
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Restore Routine (SVC 17) 



The Restore routine restarts the processing of requests that have been dequeued by 
means of the Purge routine if Halt I/O option was not specified with the 
purge-by-TCB option. Using a pointer to the first lOB in a chain of lOBs that it 
receives as input in register 1, the Restore routine issues the EXCP macro instruction 
for each lOB in the chain. 



DEVTYPE Routine (SVC 24) 



The DEVTYPE routine suppUes information about the characteristics of I/O devices. 
The instructions in the expansion of the Locate Device Characteristics (DEVTYPE) 
macro instruction place parameters into general registers, and the DEVTYPE routine 
uses the parameters to identify the device and to find where it should place the output 
information. 

The DEVTYPE macro instruction is described in the pubUcation OS Data 
Management for System Programmers, GC28-6550. 

Using the DD name it receives as input, the DEVTYPE routine finds the corresponding 

laaK input/ vjuupui lauiv v, i a'-' 1 7 uim}', aiiu uisv.-^ 11 nj iwvalv^ mv \jiyj\J\^i \^K^D. i Iiw 

DEVTYPE routine then obtains the device type field from the UCB and places it into 
the first word of the output area. 

If the DEVTAB parameter was not specified, the output area will contain two words of 
information. The DEVTYPE routine determines the maximum block size from the 
device charactersitics table (if the device is a direct access device) or from internal 
constants, and moves it to the second word of the output area. 

If the DEVTAB parameter was specified in the DEVTYPE macro instruction, and the 
device is a direct access device, the DEVTYPE routine will provide three additional 
words of information. The DEVTYPE routine locates the device characteristics table 
via the communication vector table, moves the appropriate entry into the low order 
three words of the output area, and moves the blocksize field to the second word of the 
output area. 

Before relinquishing control, the DEVTYPE routine places a return code into register 
15. A return code of 00 indicates that the request was completed successfully. A 
return code of 04 indicates one of the following conditions: 

• No output area specified: The area parameter was not included in the DEVTYPE 
macro instruction. 

• DD name not found: No TIOT entry exists that corresponds to the DD name 
supplied. 

• Invalid UCB unit type field: The UCB unit type field (byte 4 of the device code 
field) does not specify a direct access, tape, or unit record device. 

A return code of 08 indicates that an invaUd output area address was specified. 
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lOHALT Routine (SVC 33) 

The lOHALT routine stops all activity on the teleprocessing device whose unit control 
block (UCB) address is passed in register 1. It does not stop activity on 
nonteleprocessing devices. 

The lOHALT routine checks the validity of the UCB address it receives by matching it 
against the UCB addresses in the UCB lookup table. If the address passed is valid and 
if the device to be stopped is a teleprocessing device, the lOHALT routine gives 
control to the resident Halt I/O routine (entry point lECIHIO), which issues a Halt 
I/O instruction and returns. The lOHALT routine places a completion code into 
register 15 before relinquishing control: 

Code (Hex.) Meaning 

00 The device was stopped. 

04 The device is not running. 

08 The device was not stopped because it is not a 

teleprocessing device. 
OC The device was not stopped because the UCB address 

was invalid. 

SYSl.LOGREC Recorder and Statistics Update Routine (SVC 76) 

The SYSl.LOGREC Recorder and Statistics Update routine (IFBSTAT) writes records 
on the SYSl.LOGREC data set, formats records when the End-of-Day (EOD) 
command is entered, and issues warning and error messages when an I/O error occurs 
during recording operations or when the SYSl.LOGREC data set is full or nearly full. 

The first load module of IFBSTAT receives control from the Outboard Recording 
routine and the Miscellaneous Data Recording routine when records are to be written 
on the SYSl.LOGREC data set. It also records data formatted by the second and 
third load modules of IFBSTAT. The requestor of a recording operation places a 
pointer to the data to be recorded in register 1 and the twos complement of the record 
length in register 0. 

The second and third load modules of IFBSTAT receive control when an End-of-Day 
(EOD) command is entered. They build Short OBR records (Figure 40) for each 
device whose statistical counters contain a nonzero value. 

The fourth SVC 76 load module issues environment recording error messages. Diagram 
15 illustrates this function. 

VOLSTAT Routine (SVC 91) 

The first load module of the VOLSTAT routine constructs error-statistics-by-volume 
(ESV) records and, depending upon what was specified during system generation, 
writes them on either the console output device or the system management facilities 
SYSl.MAN data set. 

Data management Close and EOV routines pass control to the VOLSTAT routine 
when the volume is demounted. 

VOLSTAT routine obtains error statistics from the volume statistics table, and obtains 
other identifying information from the UCB, DCB, or JFCB and DEB. After writing 
an ESV record, the VOLSTAT routine clears the counters in the volume statistics table 
and returns control to the Close or EOV routine. 
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The second load module is called to read the buffered log data of an IBM 2305 Fixed 
Head Storage or an IBM 3330 Disk Storage. This load module is activated when a new 
volume is mounted or when the operator enters a HALT EOD command. 



TCB EXCP (SVC 92) (TSO only) 



The TCB EXCP routine allows the user to specify, in register 0, a TCB address 
associated with the lOB address passed in register 1 . The specified TCB will be the 
one associated with the RQE. 



Extended SVC Routine (SVC 109) 



An Extended SVC routine (IGX00015) is used by the Task Termination routine to insure that 
a task does not leave outstanding I/O requests. 

The routine checks each RQE in the system, unless outstanding teleprocessing-based I/O 
is found. If an RQE is assigned, the TCB is checked for an equal condition. If the equal 
condition is found, the UCB is checked for a teleprocessing-device indicator. If the 
device indicator is found, an ABEND is issued. 

If there are no RQEs assigned for the terminating task, an SVC 3 is issued. If the 
assigned RQEs do not represent the teleprocessing-associated I/O, the Extended SVC 
routine issues the PURGE macro to call the Purge routine (SVC 16). If an lOB chain for 
the Restore routine (SVC 17) results, an ABEND is issued. If no lOB chain is built, an 
SVC 3 is issued. 
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Appendix B: Alternate Path Retry 



In systems with the alternate path selective retry option, when a device can be reached 
by more than one path and there is a failure of one of the paths, the others are 
automatically tried, one by one, either until the operation is successful or until the error 
is declared permanent. In addition, the operator is provided with a Vary Path 
command by which he may add or remove paths to a device. The two alternate path 
retry functions are called 'selective retry' and 'vary path,' respectively. 



The Selective Retry Function 



Without alternate path retry, each time there is a channel failure and the Test Channel 
routine is entered preparatory to retrying the I/O activity, it selects a path for the retry 
from the alternate path table. The selected path may or may not be the failing channel, 
because the alternate path table is not changed after I/O errors. 

With alternate path retry, the Test Channel routine refers to the path mask field of the 
unit control block for the requested device rather than to the alternate path table, and 
failing paths are removed from the path mask when channel errors occur. 

Error recovery routines pass control to the Alternate Path Retry (Chart EA) before 
attempting each restart. The Alternate Path Retry routine obtains and saves the 
original channel mask from the requested device's unit control block in a table called 
the channel error block table. It then turns off the faiUng channel's bit in the channel 
mask field of the unit control block and returns control to the I/O error routine, which 
begins the retry attempts. 

To prevent a situation where all paths would become unavailable, the Alternate Path 
Retry routine restores the original path mask to the unit control block if the last 
available path is about to be used. The I/O error routine may then initiate the retry 
cycle again, depending upon whether the specified number of retries has been reached. 



The Vary Path Function 



When the operator issues any command, job management command processing routines 
are entered. For the Vary Path command, the Vary Path Command Processor routine 
is given control (Figure 51). It adds or removes paths to a device by setting bits in the 
path mask table of a unit control block on or off. 
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Figure 51. Vary Path Command Processing 
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Appendix C: Channel Check Handler (IGFCAT) 

The Channel Check Handler (CCH) can be used with the System/360 2860, 2870, 
and 2880 stand-alone channels, and the System/370 135, 145, 155, 165, and 195 
integrated channels. Use of CCH is either optional, mandatory, or automatic as 
follows: 



For Models 65, 75, and 91: 
generated. 

For Model 65 Multiprocessin| 
generated. 



CCH may optionally be selected when the system is 



CCH must be specified when the system is 



For Models 85, 135, 145, 155, 165, and 195: CCH is automatically included. 

CCH consists of one permanently resident module, which is channel — and 

model — independent, and eight channel-dependent channel error analysis 

routines — one each for the 2860, 2870, 2880, 135, 145, 155, 165, and 195 channels. 

The analysis routines reside on SYSl.LINKLIB before nucleus initialization. At 

nucleus initialization, only those analysis routines needed for the channels in the system 

and onUne are made resident in the nucleus. See OS IPL & NIP Logic, 

GY28-6661, for more information about nucleus initiaUzation of CCH. 



Channel Logout Pending 



CCH Processing 



If a channel error occurs (asynchronous or associated with an active request) on a 2880 
block multiplexor channel or an integrated block multiplexor channel (Models 145 or 
155) while lOS is running in a disabled state, and lOS attempts to issue a SIO or HIO 
instruction to that channel, a channel logout pending condition occurs. The channel 
presents condition code 1 as initial status for the I/O instruction. A full CSW will be 
stored. The CSW is all zeros except for bit 5 (channel logout pending) and bit 45 
(channel control check). When lOS detects this condition, it enables I/O interruptions, 
allowing the channel to logout. lOS fields the interruption (reflecting the channel 
error) and after passing control to and receiving it back from CCH, resumes processing 
any I/O requests that were delayed by the channel logout pending condition (Chart 
BR). 



CCH is entered at entry point IGFCAT from various routines within the I/O 
supervisor when a channel check condition is detected (bits 44, 45, or 46 set in the 
CSW, indicating channel data check, channel control check, and interface control 
check, respectively). 

CCH constructs an error recovery procedure interface block (ERPIB) which contains 
the information a device-dependent error recovery procedure needs to set up for a 
retry of the operation by the I/O supervisor. An inboard record for SYSl.LOGREC is 
also constructed by CCH; it contains the last four bytes of the ERPIB, the channel 
logout, and other information describing the environment of the channel failure. An 
operator awareness message is issued by the outboard recorder routine of the I/O 
supervisor each time an inboard record is written on SYSl.LOGREC. 

The I/O supervisor gives control to CCH through the SER interface routine 
(SERR04). CCH receives control from any one of seven exit points in five routines of 
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the I/O supervisor. At each exit point, a specific code is passed to CCH. See Table 

38. 

Table 38. Exit Codes Passed to CCH by I/O Supervisor Routines 



I/O Supervisor 




Decimal 


Symbolic 


Routine 


I/O Supervisor 


Exit 


Entry Point 


Exit Point 


Routine 


Code 


in CCH 


Following an SIO 


Direct-access start 





CCHSSK 


instruction 








Following a TIO 


Direct-access start 4 




CCHTIOSK 


instruction 








Following an SIO 


Sense subroutine 


8 


CCHSNS 


instruction 








Following a TIO 


Sense subroutine 


12 


CCHTIOSN 


instruction 








Following an SIO 


Post start I/O 


16 


CCHSiO 


instruction 








Following an 


I/O Interruption 


20 


CCHINT 


interruption 


supervisor 






Following an HlO 


Halt I/O subroutine 


24 


CCHHIO 


instruction 









This code is placed into the high-order byte of the CCH base register (register 15) by 
the I/O supervisor routine in control before any instructions are executed, enabling 
CCH to determine which routine had control when the channel check interruption was 
detected. CCH retrieves this code from register 15 and uses it to branch to the 
appropriate CCH interception-dependent routine (that is, the CCH routine that is later 
entered depending on which I/O supervisor routine intercepted the channel error). 

At various points in its processing, CCH must decide to do one of the following, 
depending on the type and severity of the failure: 

• If recovery from the channel error is possible, control is returned to the I/O 
supervisor. The I/O supervisor gives control to the appropriate device-dependent 
error recovery procedure (ERP). 

• If recovery from the channel error is not possible (the failure environment is 
invalid or a system reset has occurred), control is passed to the machine check 
handler to write the inboard record on SYSl.LOGREC and to place the system in 
the wait state. If the machine check handler is not in the system, SERO or SERl 
is entered. If no SER is in the system, the wait state is entered. 

CCH always produces an ERPIB. This block is intended to be placed in the ERPIB 
table for use by the appropriate ERP and in the inboard record. However, in some 
cases (such as catastrophic error, nonretryable condition, or the ERP not needing an 
ERPIB to set up for retry), the ERPIB is not placed in the ERPIB table but is 
produced only for inclusion in the inboard record. When a CCH routine determines 
that the ERPIB is not to be placed in the ERPIB table, the routine sets the record-only 
switch to indicate to other CCH routines that the ERPIB will be used only for the 
inboard record. 
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CCH Routines 






• Initial entry routines. These routines find available ERPIBs and inboard records 
and fill them with information that is not channel or interception-dependent. 

• Interception-dependent routines. The appropriate routine for the error is entered 
from a branch table. It sets a bit to indicate from where CCH was entered, and 
then passes control to ERPIBSET. Upon return from ERPIBSET, it passes 
control to the UCB search routine. 

• ERPIBSET routine. This routine fills the ERPIB with more common information. 
It then passes control to the correct analysis routine to complete the ERPIB. 

• UCB search routine. This routine completes the inboard record by fiUing in the 
addresses of up to eight devices active on the channel at the time of failure. It 
then returns control to the I/O supervisor. 

The remainder of CCH is composed of the analysis routines. Only the analysis routine 
for the channel on which the error occurred is entered when a channel fails. 



Initial Entry Routines 

An initial entry routine gains control first. This routine inserts X'Ol' into byte 3 of the 
machine check new PSW. If a machine check interruption occurs during CCH 
processing, this code indicates to the machine check handler that CCH was in control 
when the interruption occurred. This initial entry routine then checks for a system 
termination condition. If one exists, CCH will process the channel error and produce 
an inboard record to be written by the machine check handler. When no system 
termination condition is indicated, the ERPIB entry find routine gets control. 

The ERPIB entry find routine scans the ERPIB table to find an available ERPIB, and 
checks to see if a previous error occurred on the failing channel. This routine can also 
free an ERPIB, if necessary, for placement in an inboard record for the machine check 
handler to write on SYSl.LOGP-EC. The data collection routine then pets control, 

The data collection routine scans the inboard record area to find an available inboard 
record. If it finds one, the routine sets a bit in the CCH parameter table for use by the 
statistic data recorder routine and the statistics update routine of the I/O supervisor. If 
no inboard record is available, it passes control to the branch table routine. The data 
collection routine also checks to see if it was entered because a system termination 
condition exists. If so, this routine frees an inboard record and fills it with common 
information. The branch table routine then gets control. 

The branch table routine routes control to the correct interception-dependent routine. 
The exit code provided by the I/O supervisor routine is used as an index value into the 
branch table. 

Interception-Dependent Routines 

There are four interception-dependent routines: 

Sense interception routine (CCHSN or CCHTIOSN) 

Stand-alone Seek/Start I/O interception routine (CCHSSK, CCHTIOSK, or 
CCHSIO) 
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• Interruption interception routine (CCHINT) 

Halt I/O interception routine (CCHHIO) 

Each interception-dependent routine sets a bit in the ERPIB to indicate where the 
channel check was intercepted, and passes control to the ERPIBSET routine to 
complete the ERPIB. Upon return from ERPIBSET, the interception-dependent 
routine passes control to the UCB search routine. 

• The sense interception routine also checks the termination and sequence codes in 
the ERPIB (upon return from ERPIBSET) for selective reset and system reset 
conditions. Either of these conditions, or a fourth entry for a channel control 
check or an interface control check, causes this routine to set the no-retry bit in 
the ERPIB to indicate a channel error in the lOB, and to delete the sense 
operation. 

• The interruption interception routine also checks for a special-handling condition 
to handle asynchronous device and attention interruptions. It then zeros the 
proper CSW bits. 

• The Halt I/O interception routine passes control to the ERPIBSET routine to 
create an ERPIB for the inboard record only. No error recovery is attempted if a 
Halt I/O instruction has failed, because a channel error during a Halt I/O 
operation results. in a stopped device. 



ERPIBSET Routine 



The ERPIBSET routine first moves the UCB address to the ERPIB. The routine then 
branches to the appropriate channel error analysis routine to complete the ERPIB. 
Upon return, various conditions are checked. The ERPIBSET routine next moves the 
ERPIB and the failing CCW into the inboard record. It moves the ERPIB into the 
ERPIB table, to be used for retry by the error recovery procedure if the error recovery 
procedure can retry the operation. The ERPIBSET routine then returns control to the 
interception-dependent routine from which it received control. 



UCB Search Routine 



The UCB search routine completes the inboard record by moving into it the addresses 
of up to eight busy units on the channel at the time of failure. It then places 
multiprocessing information in the inboard record if necessary. The routine cannot 
complete the inboard record if none is available. 

This routine also checks for a system termination condition to determine if a recursion 
through CCH is needed to construct an inboard record. If a recursion is needed, this 
routine loads X'OF' at decimal location 115, loads the machine check new PSW, and 
thus gives the machine check handler control to write the inboard record on 
SYSl.LOGREC and to terminate the system. If system termination is not required, 
this routine clears the code at decimal location 115, and reenters the I/O supervisor at 
the location indicated in register 14. 
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Channel Error Analysis Routines 

CCH has a separate channei error anaiysis routine for each type of channel. 

2860 Channel Error Analysis Routine (IGFCCH60) 

The 2860 analysis routine checks the channel logout data at decimal location 304. If 
the channel logout contains a full word of ones (indicating that the channel failed to 
log out fully), the routine indicates record-only, system-termination, and no-log 
conditions. These conditions are checked by other CCH routines. If the channel 
logged out successfully, the 2860 analysis routine checks the validity of the CSW fields, 
and sets appropriate bits. 

The routine then sets sequence and termination codes in the ERPIB based on the 
presence of a channel control check or an interface control check. It determines the 
codes for a channel control check through count and parity checks in the 2860 parity 
check subroutine. It determines codes for an interface control check directly from the 
channel logout. 

The routine then insures vaUd unit address parity, and compares the hardware unit 
address with the unit address passed to it by the I/O supervisor. It indicates the 
validity of the unit address in the vaUdity indicator byte of the ERPIB. Finally, having 
completed the ERPIB the routine moves the 2860 channel logout into an available 
inboard record, sets the logout area to ones, and returns control to the ERPIBSET 
routine. When no inboard record is available, it returns control directly to the 
ERPIBSET routine. 

2870 Channel Error Analysis Routine (IGFCCH70) 

The 2870 analysis routine checks the channel logout data at decimal location 304. If 
the channel logout contains a full word of ones (indicating that the channel failed to 
log out fully), or if a system reset exists in the logout, the routine indicates record-only 
and system-termination conditions. These conditions are checked by other CCH 
routines. If the channel logged out successfully, the 2870 analysis routine checks the 
validitv of the CCSW fields and sets a'^'^ro'^riate bits. 

The routine then sets sequence and termination codes in the ERPIB based on the 
presence of a channel control check or an interface control check. It determines the 
codes for a channel control check through parity, count, and/or data transfer checks. 
It determines codes for an interface control check directly from the channel logout. 

The routine then ensures valid unit address parity and compares the hardware unit 
address with the unit address passed to it by the I/O supervisor. It indicates the 
vaUdity of the unit address in the vahdity indicator byte of the ERPIB. Finally, having 
completed the ERPIB, the routine moves the 2870 channel logout into an available 
inboard record, sets the logout area to ones, and returns control to the ERPIBSET 
routine. When no inboard record is available, it returns control directly to the 
ERPIBSET routine. 

2880 Channel Error Analysis Routine (IGFCCH80) 

The 2880 analysis routine operates differently from the 2860 and 2870 routines. It 
analyzes nine words of the 28 -word logout and fills the ERPIB with the results of that 
analysis. It does not indicate termination code 3 (system reset) in the ERPIB because 
the 2880 channel does not issue system reset to a device. It can issue sequence codes 
of to 5. 
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The 2880 analysis routine differs by issuing an "equipment check" for an incomplete 
channel logout, an unreliable CSW, or a unit address in the PSW that cannot be 
guaranteed correct. The "equipment check" is similar to a machine check except that it 
indicates whether the channel represented the correct data to the CPU. 

The routine determines the logout address, since it varies depending on the CPU to 
which the 2880 channel is attached and checks for a no-log condition to determine 
whether normal operations should continue. If they should, several other tests are 
performed. 

If a channel data check is present, the routine indicates a record-only condition and: 

1 . Sets a bit in the validity indicator byte 

2. Moves the ERPIB to an available inboard record 

3. Sets the logout area to ones 

4. Returns control to the ERPIBSET routine 

If an inboard record is not available, control passes directly to the ERPIBSET routine. 

If a channel control check or an interface control check occurred and the channel 
logout contains a fuUword of ones, the routine indicates record-only and 
system-termination conditions before it 

1 . Sets a bit in the vaUdity indicator byte 

2. Moves the ERPIB to an available record 

3. Sets the logout area to ones 

4. Returns control to the ERPIBSET routine 

The routine then determines the proper sequence and termination codes, checks the 
command address, unit address, and unit status validity, and indicates a valid retry 
condition in the ERPIB. 

If the no-log switch is set, the routine compares the channel number in the I/O old 
PSW against the channel number in the channel logout. A m.atch causes normal 
operations to continue after indicating the no-log conditions. No match means that 
recovery is impossible, so the routine indicates a system termination condition and: 

1 . Sets a bit in the validity indicator byte 

2. Moves the ERPIB to an available record 

3. Sets the logout area to ones 

4. Returns control to the ERPIBSET routine 



135 Channel Error Analysis Routine (IGFCCH35) 



The 135 analysis routine differs from the 2860, 2870, and 2880 analysis routines in 
that it does not analyze the channel logout; instead, it uses the hardware-generated 
extended channel status word (ECSW). Since the ECSW contains the same type of 
information as the last three bytes of the ERPIB, the routine moves the last three bytes 
of the ECSW from decimal location 176 to the last three bytes of the ERPIB. 

If the instruction on which the error occurred was a Test I/O, this routine compares 
the unit address supplied by the hardware in decimal location 186 with the unit address 
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passed by the I/O supervisor. If they do not match, the routine sets the unit address 
vaUd bit in the work ERPIB to zero. 

If there is vaUd channel logout data and an inboard record is being created, the routine 
saves the logout in the inboard record. The logout is copied from decimal location 256. 



145 Channel Error Analysis Routine (IGFCCH68) 



Like the 135 analysis routine, the 145 analysis routine moves the last three bytes of the 
ECSW from decimal location 176 to the last three bytes of the ERPIB. 

If the instruction on which the error occurred was a Test I/O, this routine compares 
the unit address supplied by the hardware in decimal location 186 with the unit address 
passed by the I/O supervisor. If they do not match, the routine sets the unit address 
valid bit in the work ERPIB to zero. 

If there is a valid channel logout and an inboard record is being created, the routine 
saves the logout in the inboard record. The I/O extended logout (lOEL) pointer in 
decimal location 172 points to the logout area from which the logout can be copied. 



155 Channel Error Analysis Routine (IGFCCH48) 



Like the 135 and 145 analysis routines, the 155 analysis routine moves the last three 
bytes of the ECSW from decimal location 176 to the last three bytes of the ERPIB. 

If the instruction on which the error occurred was a Test I/O, this routine compares 
the unit address supplied by the hardware in decimal location 186 with the unit address 
passed by the I/O supervisor. If they do not match, the routine sets the unit address 
valid bit in the work ERPIB to zero. 

The 155 channels do not log out. 
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Appendix D: Direct- Access Volume Verification 

If the option to verify volume serial numbers is selected during system generation, the 
input/output supervisor checks the serial numbers of newly mounted volumes against 
serial numbers in the unit control blocks (UCBs) for the devices containing the 
volumes. It issues messages to the operator when the wrong volumes have been 
mounted. 

When an operator readies a device after mounting a volume, he causes an I/O 
interruption and entry to the I/O interruption supervisor. If the UCB for that device 
contains a volume serial number, the I/O interruption supervisor sets a flag in the UCB 
for the device to indicate that volume verification is to be performed. The next time 
there is a request for activity on the device, the I/O supervisor, having checked the 
flag, schedules module IGE0025E. When IGE0025E gains control, it checks the flag 
in the UCB to determine if volume verification is required. If it is, control is 
transferred to module IGE0125E, the first module of the two-module volume 
verification routine. 

Module IGE0125E tests if the UCB volume serial number is zeros or if the data 
management bit is set. If so, an SVC 15 instruction is issued to execute the user's 
channel program. If, however, there is a volume serial number in the UCB and the 
mount bit is not on, module IGE0125E constructs a channel program to read the 
volume label for the mounted volume and issues an SVC 15 instruction to cause the 
channel program to be executed. When it receives control a second time, after the 
volume label has been read, module IGE0125E matches the volume serial number of 
the mounted volume against the serial number in the UCB for the device. When the 
serial numbers agree, IGE0125E uses an SVC 15 instruction to cause the originally 
requested activity to be performed. If the volume serial numbers do not agree, or if the 
channel program was terminated in error IGE0125E invokes the second module of the 
Volume Verification routine IGE0225E. The second module issues a demount message 
for the mounted volume and a mount message for the volume whose serial number 
appears in the UCB. 

If an I/O error occurs during reading of the volume label, 10 retries are attempted. If 
the condition cannot be corrected, IGE0125E invokes IGE0225E to issue an error 
message. 



266 OS I/O Supervisor Logic 



Appendix E: Dynamic Device Reconfiguration 



In systems with the dynamic device reconfiguration option, a volume mounted and in 
use on one device can be removed and taken to another device where the activity on 
the volume will be resumed. Volumes can be moved at the request of an operator or, 
when there is a permanent I/O error, at the request of the system. Such moves can be 

because I/O supervisor dynamic device reconfiguration (DDR) routines effectively 
reallocate by exchanging the device-dependent information in the unit control blocks of 
the two already allocated devices. The affected devices may be contained in different 
logical channels, because DDR routines also transfer the request queue elements for 
any queued requests for the devices to the correct logical channel queues. 

The routines that perform dynamic device reconfiguration are shown in Figure 52. 

Both the DDR SWAP Command Processor routine and the DDR Central routine 
perform preliminary work that includes checking the validity of the devices involved in 
the exchange and making sure they are eUgible for the exchange. Either routine then 
posts a DDR event control block, causing a high-priority DDR TCB to be made ready 
by the supervisor. In dispatching the DDR task, the supervisor's Dispatcher routine 
gives control to the DDR Wait routine, which issues an SVC 85 instruction to cause 
entry to the DDR SVC Router routine. Depending upon the type of request, the DDR 
SVC Router routine gives control to one of three main DDR routines. 

The Operator-Initiated DDR routine, System-Initiated DDR routine, and the DDR 
Tape Reposition routine direct any input/output activity needed for the volume 
exchange, find devices for volumes being moved after permanent I/O errors, and 
perform the exchange of UCB information. They do so indirectly, however, by setting 
switches to indicate what is to be done and then issuing SVC 1 5 instructions. The 
SVC 15 instructions cause entry, via the Error EXCP routine, to the DDR channel end 
or abnormal end appendages. The appendages check the switches and use the dynamic 
device reconfiguration vector table (Table 39) to route control to the resident I/O 
supervisor routines where the needed functions are performed. 

Optionally, dynamic device reconfiguration can be specified for system residence 
devices. When this is the case, separate routines are used (Figure 52), but the logic is 
basically similar to that used for non-system-residence devices. 
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Figure 52 (Part 1 of 2). Performing Dynamic Device Reconfiguration 
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Figure 52 (Part 2 of 2). Performing Dynamic Device Reconfiguration 
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Table 39. Dynamic Device Reconfiguration Vector Table 
Offset Vector Description 

Address of dynamic device reconfiguration (DDR) 



DDRXCPWC 



12 



16 



DDRXCPNC 



DDRPSTNC 



DDRPSTWC 



20 



DDRRETRY 



24 



DDRSWAP 



28 



DDRCANCL 



32 
36 



DDRSRCAN 
DDRXCPSR 



wait queue. 

Re-EXCP with control of UCB. 

The RQE representing the DDR activity is placed into a 
logical channel queue, and other activity scheduled 
for the I/O device is prevented from starting. The DDR 
activity will be the first to be performed on the device. 

This vector is taken when a sequence of related I/O 
operations is in progress, as happens during reposi- 
tioning of magnetic tape volumes. 

Re-EXCP without control of UCB. 

The RQE representing the DDR activity is placed into 
a logical channel queue, where it will be processed in 
turn. 

Post DDR without control of UCB. 

The requestor's ECB is posted and non-DDR activity is 
permitted to resume on the I/O device. 

Post DDR with control of UCB. 

The requestor's ECB is posted but non-DDR activity is 
prevented from starting on the I/O device. 

This vector is taken when one of a sequence of related 
I/O operations is completed (see DDRXCPWC vector). 

Retry user after swap. 

The requestor's RQE is placed into a logical channel 
queue and other activity scheduled for the I/O device 
is prevented from starting. The requestor's activity 
will be the first to be performed on the device. 

This vector is taken when a volume has been changed 
to a second device and activity can be resumed on the 
new device. 

Swap UCB information. 

The information in the UCB of one device is exchanged 
with the information in the UCB of another device. If 
the devices are not contained in the same logical 
channel, the RQEs representing requests for the devices 
are moved to the correct logical channels. 

DDR request cancelled by operator. 

The RQE is removed from the wait queue and non- 
DDR activity is permitted to resume on the device. 

This vector is taken when the operator cancels a request 
to move a volume to another device. 

Cancel SYSRES-DDR request. The DDR RQE is 
removed from the logical channel queue. 

Retry SYSRES-DDR request after CC3. 

The UCBASK flag is set to indicate that the seek is 
complete. Other activity scheduled for the I/O 
device is prevented from starting. 
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Appendix F: Multiprocessing Extensions 



The I/O supervisor is extended to implement multiprocessing if the M65MP option is 
selected at system generation. In multiprocessing, I/O devices can be accessible from 
each CPU through its own channels. If the CPU originating an I/O operation finds 
that its own channel is not available, it tests the availability of the corresponding 
channel of the other CPU ^all channel— control unit— device addresses are the same for 
both CPUs). If the other CPU's channel is free, the originating CPU issues a 
"shoulder tap," causing an external interruption on the receiving CPU, which then 
initiates the I/O operation. 



Tables and Work Areas 



The unit control block (UCB) is extended by a full word for multiprocessing. (See 
Figure 45, Section 5.) The first byte of this word contains flags indicating which CPU 
started the current operation, if one is in progress. The extension is located "in front 
of" the UCB, but does not affect the displacement of other UCB fields. It is addressed 
by subtracting four from the UCB address. 

Multiprocessing requires a new .channel availability table in the prefixed storage area 
(PSA) of each CPU. (See Figure 16, Section 5.) A channel is marked unavailable in 
this table when: 

• SIO is issued. This condition is cleared by the I/O interruption supervisor when 
the I/O operation completes. 

• The nucleus initialization program determines that the channel is not operational 
or not included in the system. 

A VARY CHANNEL or VARY CPU command from the operator places the 
channel offline. 



Extended Test Channel Logic 



The Test Channel Common routine (XCPTCH) of the EXCP supervisor, under 
multiprocessing, makes a second test after finding that the requested physical channel is 
busy or not available. The Test Channel Common routine determines whether the 
corresponding channel of the other CPU is free by testing the channel availability table 
in the other CPU's prefixed storage area. If the table shows the channel is free, the 
Shoulder Tap Interface subroutine (XCPSTI) is given control. The subroutine sets a 
flag in the shoulder tap control word (STMASK), then branches to the Shoulder Tap 
routine (SHOLDTAP). The Shoulder Tap routine issues the Write Direct instruction to 
notify the other CPU. On return from the Shoulder Tap Interface subroutine, the I/O 
request element is queued to that channel, where the other CPU will find it after the 
I/O supervisor is unlocked by the requesting CPU (only one CPU executes the I/O 
supervisor at a time). 

If neither CPU has an available channel, the request element is queued pending an 
interruption on either CPU. 
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Multiprocessing Subroutines 



The following subroutines (with entry points in parentheses) are included in the I/O 
supervisor for the multiprocessing option: 

• Shoulder Tap Interface — Sending. This subroutine sets a flag (in the shoulder tap 
control word in the PSA of the sending CPU) that indicates to the receiving 
CPU the channel for which- an I/O operation is requested. The subroutine 
branches to a common system routine to execute the Write Direct instruction 
causing an external interruption on the other CPU. 

• Shoulder Tap Interface — Receiving (lECISHTP). This routine receives control 
from the external FLIH after an I/O shoulder tap. It goes to the Channel Restart 
routine of the I/O interruption supervisor to start any request that has been 
placed on the channel queue by the sending CPU. 

VARY Interface (lECTIOMP and lECTCHMP). This subroutine issues the Test 
I/O and Test Channel instructions for the VARY command handling routines. 

• Accessibility Test. This code is part of the test channel code (XCPTCH2). It 
tests the path accessibiUty flags (UCBCHM) of the UCB to ensure that a CPU 
about to start an I/O operation has access to the device. A CPU does not have 
access to the other CPU's console, and only one CPU has access to teleprocessing 
devices. 

Halt I/O Check (lECMPHIO). An I/O operation can be halted only by the 
CPU that initiated it. The PSA of each CPU contains a unique identifier that is 
placed in the UCB extension whenever SIO is issued for a device. When a Halt 
I/O is requested, this routine compares the identifier of the executing CPU to the 
identifier in the UCB extension. If they are the same, control is returned to the 
resident HIO routine. If different, flags are set in the shoulder tap control word 
in the UCB prefix segment, and a shoulder tap is performed. 

• Shoulder Tap Halt I/O (HLTIOUNT). This routine receives control following a 
shoulder tap for Halt I/O. It searches the flags set by the Halt I/O Check 
routine, and passes control to the Resident HIO routine. 
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Appendix G: Program Check Recovery Subroutine (PCRS) 

The Program Check Recovery Subroutine is assembled within I/O supervisor code for 
MFT, MVT, and M65MP systems. It acts in conjunction with the optional Program 
Check Handler to handle program check errors. The Program Check Subroutine works 
with the two sections of the Program Check Handler, Prolog and Abterm, to clean up 
the 1/ O supervisor control blocks and queues, and to terminate tasks. The Program 
Check Recovery Subroutine gains control from the Prolog section of the Program 
Check Handler when a program check error occurs in a task in the I/O supervisor, its 
appendages, or any routine branched to by the I/O supervisor. See Figure 53 for the 
general flow of control. 

Preparations for processing a program check begin before an error occurs. The I/O 
supervisor, when it first gets control of an RQE, saves the address of the RQE in a 
special save area LTSVALSV. This allows the Program Check Recovery Subroutine to 
determine the interrupted task without depending on the passing of registers between 
the routines which gain control at a program check. The Program Check Recovery 
Subroutine dequeues the RQE from its logical channel queue by using the address at 
LTSVALSV, and sets the flags in UCBFLl to zero, to clear them, for the next RQE. 
Finally, the Program Check Recovery Subroutine determines the associated TCB for 
the task, checks its validity, and determines the proper ABEND code. Control passes 
from the Program Check Recovery Subroutine to the Abterm section of the Program 
Check Handler, which schedules the termination. The program check error handUng 
ends when Abterm gives control back to to the I/O supervisor which places the RQE 
in the freehst and exits either to the SVC First Level Interruption Handler, if the 
program check occurred during an SVC 0, or to the Channel Restart, if the program 
check occurred during an SVC 15 or an I/O interruption. Now the I/O supervisor 
readies itself for a new RQE by zeroing out the special save area LTSVALSV. 

Two exceptional conditions may arise: there may be no RQE associated with the 
program check, indicated by the save area LTSVALSV being zero, and a recurrence 
may occur in the Program Check Recovery Subroutine. 

When there is no vaUd RQE, the Program Check Recovery Subroutine determines if an 
SVC was in process, and if so, the task pointed to by the current TCB is abnormally 
terminated with the appropriate completion code (400 or 0F2). If there is no valid 
RQE and either an SVC 15 or interrupt is in process, abnormal termination is not 
attempted. 

In case of recurrence, the Program Check Recovery Subroutine determines if there is a 
vaUd RQE, and if so, determines if there is a vaUd TCB. If a vaUd RQE and TCB can 
be determined, the task is abnormally terminated with the appropriate completion code. 
If there is no vaUd RQE or no valid TCB, processing is handled the same way as when 
there is no valid RQE. 
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Appendix H: Shared Direct— Access Storage Device 



"IT - 



The Shared DASD option allows one direct-access device to be shared between two 
CPUs.- The I/O supervisor must, therefore, provide special code to allow successful 
data transfer between the device and each CPU. Since a program seeking access to a 
shared-file device may require either exclusive use of the device or shared use of the 
device, the I/O supervisor uses two special command codes, RELEASE and 
RESERVE. RESERVE (X'B4') manipulates the swithcing device to allow exclusive 
use of the device by the CPU; RELEASE (X'94') manipulates the switching device to 
aliOv/ shared use of the device by the CPU. A program requiring exclusive use of the 
shared device must issue a RESERVE macro. This causes the RESERVE count in the 
UCB to be incremented. Once the RESERVE command is issued, the other CPU has 
no access to the device until a RELEASE command is issued to the device. The I/O 
supervisor issues a RELEASE command if the RESERVE count field is zero. This 
count field is decremented each time the user issues a DEQ macro. 

Regardless of whether or not the user has issued a RESERVE macro, the I/O 
supervisor must also issue a RESERVE command with every stand-alone seek, 
regardless of the value in the RESERVE count fields. This prevents the other CPU 
from moving the access mechanism once it has been positioned for the first CPU. In 
the event the RESERVE count is zero, a RELEASE is issued with the data transfer 
channel program to free the device for the other CPU. 

If a unit check or a channel error requires a sense operation to be done, a read home 
address and record zero channel program is chained to the sense command; if the 
RESERVE count in the UCB is zero, the sense command is changed to a RELEASE 
command — a special type of sense command. The home address and record zero data, 
read into the UCB's work area, is required by the device-dependent error recovery 
procedure. The RELEASE command frees the device for possible use by the second 
CPU during the first CPU's error recovery cycle. 



If an active shared device is associated with a purged request, the UCB's HIO flag is 
set by the PURGE routine. This caus 
device, if its RESERVE count is zero. 



set by the PURGE routine. This causes the I/O supervisor to issue a RELEASE to the 
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Appendix I: I/O Supervisor Messages 

The I/O supervisor can write the following messages to the operator: 

lEAOOOA Intervention required 

lEAOOOI Uncorrectable input/output error 

lEAOOlI Inoperative path 

IEA604A Demount volume 

IEA605A Mount volume 

IEA606I Bad volume label 

IFBOOII I/O error during SER 

IFB003I SER recording area full 

IFB002I Channel detected error 

IFB004I SER disk area format error 

For complete descriptions of these messages, see the publication OS Messages and 
Codes, GC28-6631. 

The first three messages shown above are handled similarly. When an I/O error 
routine determines that a message is needed, it invokes the I/O supervisor's 
Write-to-Operator routine, which composes the text of the message and issues an SVC 
35 instruction. Actual writing of the message is performed by the system 
Write-to-Operator SVC routine. 

The next three messages in the list are produced by the optional Volume Verification 
routine, which checks serial numbers of newly mounted volumes. 

The last four messages in the Hst above are written by the System Environment 
Recording Message routine, which is invoked when one of the environment data 
recording routines cannot write into the SYSl.LOGREC data set. 



276 OS I/O Supervisor Logic 



Page of GY28-66 16-9 
Revised April 30, 1973 
By TNL GN26-8036 



Appendix J: I/O Supervisor — OLTEP Synchronizing Module-IECIOLTS 

OLTEP requires the following special support from the I/O supervisor: 

Attention-interruption posting 

Device-end posting when device-end occurs separately from channel-end 

Return SIO condition codes when either of above functions is active 

Exclusive use of a channel by OLTEP 

Bypassing of the system channel programs for tape devices and direct access 
devices 

Specific exposure path selection for multiple exposure devices 

The I/O supervisor maintains the module lECIOLTS which coordinates the I/O 
supervisor functions requested by OLTEP. The address of this routine is contained in 
the I/O supervisor-OLTEP vector table, lECOLTVT. 

To indicate that OLTEP requires assistance from the I/O supervisor, the SVC 59 
instruction sets a series of switches in the lECOLTSW field of lECOLTVT. The I/O 
supervisor exits from four places in its code to check these switches: 

• It exits during the Test Channel routine. 

• It exits during the Halt I/O routine. 

• It exits during the Start I/O routine. 

• It exits during the SIO module for multiple exposure devices. 

If OLTEP indicates a channel function on a 2880 channel, control passes from the Test 
Channel routine in the I/O supervisor to the subroutine in lECIOLTS at label 
OLTCHN. Processing in that subroutine determines whether or not OLTEP has 
exclusive control of a channeL 

The SIO appendage in lECIOLTS at label SIOAPP is entered normally. This 
appendage checks the bypass function bit. If it is on, normal I/O channel programs are 
bypassed and OLTEP operations continue on that channel. 

If OLTEP indicates either device-end or attention posting, control passes from the halt 
I/O routine in the I/O supervisor to the subroutine in lECIOLTS at label OLTHLT 
This subroutine determines if lOS may issue an HIO on the input device. 

Special OLTEP multiple exposure device code in the I/O supervisor exits to lECIOLTS 
at label OLTEXP to select a specific-exposure access path for OLTEP. 

More information about the routines and appendages in lECIOLTS can be found in 
OS OLTEP Logic, GY28-6651. 

The I/O supervisor uses the addressing scheme shown in Figure 54 to gain access to 
lECOLTVT. 
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Figure 54. lECIOLTS Addressing Scheme and Bit Settings 
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Appendix K: FiinctionaUy Equivalent Devices 

I/O Device Equivalent Device Description 



2319 Disk Storage 



2314 Disk Storage 



3333 Disk Storage 
and Control 



3330 Disk Storage 



The 2319 is specified as a 2314 
in system generation. It is 
also specified as a 2314 in JCL. 
Any routines described in this 
publication as applicable to the 
2314 also apply to the 2319. 



Tlie 3333 is specified as a 3330 in system 
generation. It is also specified as a 3330 in 
JCL. Any routines described in this 
publication as applicable to the 3330 also 
apply to the 3333. See Reference 
Manual for IBM 3333 Disk Storage and 
Control, GA26-1615, for more 
information about the 3333. 
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Appendix L: 


List of Abbreviations 




APR 


alternate path retry 




ASCII 


American National Standard Code for Information Interchange 




BSAM 


basic sequential access method 




BTAM 


basic teleprocessing access method 




CAW 


channel address word 




CC 


condition code; chain command 




CCC 


channel control check 




CCH 


channel check handler 




CCW 


channel command word 




CD 


chain data 




CEB 


channel error block 




CPU 


central processing unit 




CRC 


cyclic redundancy check 




CSW 


channel status word 




CUA 


channel and unit address 




DASD 


direct access storage device 




DCB 


data control block 




DDR 


dynamic device reconfiguration 




DEB 


data extent block 




DSCB 


data set control block 




EBCDIC 


extended binary-coded-decimal interchange code 




ECB 


event control block 




EOD 


end of day 




EOF 


end of file 




EOV 


end of volume 




ERG 


error record gap 




ERP 


error recovery procedure 




ERPIB 


error recovery procedure interface block 




EXCP 


execute channel program 




FIFO 


first-in first-out 




FLIH 


first level interruption handler 




HA 


home address 




HEX 


hexadecimal 




ICC 


interface control check 




ILC 


instruction length code 




I/O 


input/output 




lOB 


input/output block 




lOS 


input/output supervisor 




IPL 


initial program loading 




LCH 


logical channel 




MET 


multiprogramming with a fixed number of tasks 




MVT 


multiprogramming with a variable number of tasks 




M65MP 


Model 65 Multiprocessing 




NIP 


nucleus initialization program 




1 NRZI 


non-return-to-zero inverted recording 




OBR 


outboard recorder, outboard recording 




OLTEP 


online test executive program 




PCI 


program controlled interruption 




PCP 


primary control program 




PCU 


primary control unit 
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PLM program logic manual 

PL/I Programming Language I 

PSA prefixed storage area 

PSW program status word 

QSAM queued sequential access method 

QTAM queued teleprocessing access method 

RQE request queue element 

RO record zero 

SCU secondary control unit 

SER system environment recording 

SIO start input/output 

SLI suppress length indication 

SMF system management facilities 

SVC supervisor call 

TCB task control block 

TCH test channel 

TIC transfer in channel 

TIE track in error 
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Appendix M: Glossary 

The following terms are defined as they are used in this book. If you do not find the term you are looking 
for, refer to the index or to the IBM Data Processing Glossary, GC20-1699. 



access arm: A part of a disk storage unit that is 
used to hold one or more reading and writing 
heads. 

access mechanism: A group of access arms that 
move together as a unit. 

access method: Any of the data management 
techniques available to the user for transferring data 
between main storage and an input/output device. 

alternate track: For direct access devices, a track 
designated to contain data in place of a defective 
primary track. 

asynchronous: Without regular time relationship; 
unexpected or unpredictable with respect to the 
execution of a program's instructions. 

auxiliary storage: Data storage other than main 
storage. 

basic access method: Any access method in which 
each input/output statement causes a corresponding 
machine input/output operation to occur. (The 
primary macro instructions used are READ and 
WRITE.) Contrast with queued access method. 

basic telecommunications access method (BTAM): A 

basic access method that permits a READ /WRITE 
communication with remote devices. 

burst mode: A means of transferring data to or from 
a particular I/O device on either the multiplexor or 
selector channel. All channel controls are 
monopolized for the duration of data transfer. 

bus lines: The lines of communication between a 
channel and a control unit. Bus-out lines carry 
information from a channel to a control unit; 
bus-in Unes carry information from a control unit 
to a channel. 

byte mode: See multiplex mode. 

CAW (channel address word): A word in main 
storage at location 72 that specifies the location in 
main storage where a channel program begins. 



CCW (channel command word): A double word at 
the location in main storage specified by the CAW. 
One or more CCWs make up the channel program 
that directs channel operations. 

central processing unit (CPU): The unit of a 
computing system that contains the circuits that 
control and perform the execution of instructions. 

channel: A hardware device that connects the CPU 
and main storage with the I/O control units. 

channel command: An instruction that directs a 
channel, control unit, or device to perform an 
operation or set of operations. A channel command 
(an 8-byte data field in main storage) consists of a 
command code, a main storage address, a flag field, 
and a count. 

channel program: One or more channel command 
words (CCWs) that control(s) a specific sequence 
of channel operations. Execution of the sequence is 
initiated by a single Start I/O instruction. 

compile: To prepare a machine language program 
from a computer program written in a high-level 
source language by generating more than one 
machine instruction for each symbolic statement 
(sometimes with an intermediate generation of 
assembler language instructions). 

compiler: A program that compiles. 

control block: A storage area through which a 
particular type of information required for control 
of the operating system is communicated among its 
parts. 

CPU: (See central processing unit.) 

CSW (channel status word): A double word in main 
storage at location 64 that provides information 
about the termination of an input/output operation. 

cylinder: The tracks of a direct access device that 
are accessible with one positioning of the access 
mechanism. 

DASD: A direct-access storage device. 
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data control block (DCB): A control block used by 
access method routines in storing and retrieving 
data. 

data set control block (DSCB): A data set label for 
a data set in direct access storage. 

DCB: See data control block. 

direct access: Retrieval or storage of data by a 
reference to its location on a volume, rather than 
relative to the previously retrieved or stored data. 

direct— access device: A device in which the access 
time is effectively independent of the location of 
the data. 

disabled (masked): A state of the CPU that prevents 
the occurrence of certain types of interruptions. 

disk storage: A storage device that uses magnetic 
recording on rotating disks. 

dispatcher: In the Operating System, a supervisor 
routine of the control program. The dispatcher 
passes control to the next executable task by issuing 
a Load PSW instruction that specifies an old PSW, 
stored either in a request block or in a permanent 
location in main storage. 

dispatchii^: In multitasking, the passing of control 
to the current executable routine of the next task to 
be activated. (This routine may be the same one 
that was previously being executed.) 

drum storage: A direct access storage device which 
uses a rotating cylinder on which data is recorded 
magnetically. A type of addressable storage 
associated with some computers. 

event: An occurrence of significance to a task; 
typically, the completion of an asynchronous 
operation, such as input/output. 

event control block (ECB): A control block used to 
represent the status of an event. 

extent: An area of storage on a direct access device. 
A specific extent is delimited by a starting track 
address and an ending track address; it always 
consists of one or more full tracks. 

freelist: The chain of all free, or available, request 
queue elements. 

immediate I/O operations: Those I/O operations for 
which an I/O device signals the channel-end 
condition immediately upon receipt of the command 



code. No transfer of data takes place when 
immediate operations are performed. 

inboard record: A record on the SYSl.LOGREC 
data set containing information about a channel 
failure. 

indexed sequential organization: A data organization 
that allows access to any record without reading the 
preceding record or maintaining a separate record 
that gives the position of the desired record. The 
locating of each record in the data set depends on 
the contents of a key portion of the record = 

initial program loading (IPL): As applied to the 
operating system, the initialization procedure which 
loads the nucleus and begins operations. 

innerrecord gap: On a storage medium, an area 
used to indicate the end of a record. 

input-output error: A general term used to denote 
any of the conditions that would preclude normal 
(or successful) completion of an input/output 
operation. Input-output errors are generally a result 
of malfunctioning input/output devices. 

intercepted I/O request: A request for I/O activity 
on which processing has been suspended so that an 
I/O error routine could be used to process an error 
that occurred after channel end for the last activity 
on the needed device. 

IPL: See initial program loading. 

logical channel: The set of ail physical channels by 
which a device may be reached. 

logical channel queue: A queue into which request 
elements are placed when I/O activity cannot be 
started immediately. There is one logical channel 
queue for each logical channel. 

logical channel word: An eight-byte data area that 
contains the addresses of the first and last request 
elements in a logical channel queue. There is one 
logical channel word for each logical channel. 

logical channel word table: A term used when 
referring collectively to all of the logical channel 
words in a system. 

logout: Twenty-four bytes of status information 
which are sent to main storage locations 30410 to 
32710 by a channel following a channel control 
check. 
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macro instruction: A general term used to 
collectively describe a macro instruction statement, 
the corresponding macro instruction definition, the 
resulting assembler language statements, and the 
machine language instructions and other data 
produced from the assembler language statements; 
loosely, any one of these representations of a 
machine language instruction sequence. A 
shorthand form of coding. 

multiplex mode: A means of transferring records to 
or from low-speed I/O devices on the multiplexor 
channel, by interleaving bytes of data. The 
multiplexor channel sustains simultaneous I/O 
operations on several subchannels. Bytes of data 
are interleaved and then routed to or from the 
selected I/O devices or to and from the desired 
locations in main storage. Multiplex mode is 
sometimes referred to as byte mode. 

multiplexor channel: A channel designed to operate 
with a number of I/O devices simultaneously on a 
byte basis. That is, several I/O devices can be 
transferring records over the multiplexor channel, 
time-sharing it on a byte basis. 

nonshared subchannel: A subchannel that can service 
only one I/O device. 

nucleus: That portion of the control program that is 
loaded into the fixed area of main storage from 
SYS 1. NUCLEUS at IPL time and is never overiaid 
by another part of the operating system. 

nucleus initialization program (NIP): The program 
that initiaUzes the resident control program. It 
allows last minute changes to certain options 
specified during system generation. The operator 
makes these changes through the console. 

outboard record: A record on the SYSl.LOGREC 

data set containing information about an I/O 
device failure. 

permanent error: An input/output error that either 
cannot be corrected or remains uncorrected after 
error recovery procedures have been used. 

prefixed storage area: A 4096-byte main storage 
area in each of the two CPUs of Model 65 
Multiprocessing systems, used for storing 
CPU-related information. 

primary track: For direct-access devices, the original 
track on which data could be stored. 



processing program: Any program capable of 
operating in the problem program mode. This 
includes IBM-distributed language processors, 
application programs, service and utility programs, 
and user-written programs. 

program status word: A double word in main storage 
used to control the order in which instructions are 
executed, and to hold and indicate the status of the 
system in relation to a particular program. 

queued access method: An access method that 
automatically governs the movement of data 
between the program using the access method and 
input/output devices. (The macro instructions used 
are GET and PUT.) 

related I/O request: A request for I/O activity that 
is not to be honored unless the preceding activity 
for the effected data set has been completed 
successfully. 

routine, subroutine: Sequences of instructions that 
perform distinguishable operations. The term 
subroutine is most often used where a hierarchy 
exists, as when there is a need to distinguish 
between a major operation (performed by a 
routine) and a subordinate operation (performed by 
a subroutine). 

shared subchannel: A subchannel that can service 
more than one I/O device. 

subchannel: The channel facilities required to sustain 
an I/O operation. Selector channels have one 
subchannel; multiplexor channels have multiple 
subchannels. 

supervisor call (SVC): An instruction which causes 
an SVC interruption in the hardware to give control 
to a control program routine (called an SVC 
routine) for some specific action, such as 
reassigning parts of main storage or retrieving data 
from an I/O device. 

SVC routine: A control program routine that 
performs or initiates a control program service 
specified by a supervisor call. 

system data sets: The data sets that make up the 
Operating System. 

system macro instruction: A predefined macro 
instruction that provides access to operating system 
facilities. 
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system output unit: An output device, shared by all 
jobs, onto which specified output data is 
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SYSl.LOGREC: The system data set used to 
record statistical data about machine malfunctions. 

SYSl.SVCLIB: The partitioned system data set that 
contains the nonresident SVC routines nonresident 
error-handling routines, and access method 
routines. 



task control block (TCB): The control block 
containing control information related to a task. 

track (direct-access devices): The portion of a 
direct-access device recording surface available to a 
single read/write head at each access mechanism, 
position. 

track address: In direct access devices an address 
made up of a cylinder number and a read-write 
head number. Every track of a direct-access device 
has a unique track address. 
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operator initiated DDR routine symbolic names 

response to error 74 

write-to-operator messages 74 

write-to-operator routine symbolic names 162-164 
ordered seek queuing 

diagram 82,83 

explanation 15 
outboard record 

defined in glossary 

in data area layout 



163 



283,284 
215-217 
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outboard recorder routine 
diagram 77 
register usage 112,113 



I/O new PSW, described in module directory 165 
I/O old PSW, described in module directory 165 
SVC old PSW, described in module directory 165 





patch area 247 
permanent errors 

defined 23 

in glossary 283,284 

used for recording error data 73,74 

1052 error routine 27-29 

1403 and 1443 error routine 30-33 

1442, 2501, and 2502 error routine 40-43 

2250 error routine 43-45 

2260 and 1053 error routine 46,47 

2301, 2302, 2303, 2305, 2311, 2314, 

2321, and 3330 error routines 47-53 

2400/3400 error routine 53-59 

2495 error routine 59-62 

2540 error routine 62-65 

267 1 error routine 66-67 

3211 error routine 67-70 

3505/3525 error routine 70-73 

5450 error routine 73-75 
physical channel 

channel table 

in data area directory 168 
data area layout 189 
explanation 8,9 
post routine interface 166 
post start I/O routine 1 18 
prefixed storage area 272,273 

defined in glossary 283,284 
priority queuing 

diagram 82,83 

explanation 1 5 
program check handler 274 
program check recovery subroutine 274 
program-controlled interruption appendage 
119,120 

program fetch 104,105 
program fetch work area, I/O supervisor 
transient area 104,105 
program status word 165,169,205-207 
protection feature (see Principles 
of Operation, GA22-6821) 
purge routine (SVC 16) 

described in module directory 162,163 

explanation 249-25 1 

use of lOB 252,253 

useoflRB 252,253 

quiesce option 252-255 

RESTORE macro 252,253 

useofSIRB 254,255 
PSA (prefixed storage area) 272,273 

(see also multiprocessing, prefixed storage area) 
PSW (program status word) 

in data area directory 169 

data area layout 205-207 

defined in glossary 284 



queuing 

scheduling I/O 14,16 
terminating I/O 21 
queuing methods 
FIFO 

diagram 82,83 
explanation 1 5 
ordered seek 

diagram 82,83 
explanation 1 5 
priority 

diagram 82,83 
explanation 1 5 
quiesce option 252-255 
quiesce complete subroutine 165 




read backward command, for 1442, 2501, and 
2520 error routines 41,42 
recovery management support communications 

in data area directory 169 

in data area layout 207,208 
register usage 

channel availability test 84,85 

used in error recovery (diagram) 102-105 

used with logical channel (diagram) 82,83 

message to operator 106,107 

with MVT (diagram) 80,81 

used with RQE 80,81 

start I/O operations 
diagram 80,81 
direct access 92,93 
tape units (diagram) 88,89 

table of register usage 244,245 

used for UCB (diagram) 82,83 

used to write operator messages 1 12, 1 13 
RELEASE command 18,19 
RESERVE command 18,19 
reserve count field 28 
restart 23 

RESTORE macro 250,251 
restore routine 251 
RQE (request queue element) 

channel end status 21 

in data area directory 169 

initialization of RQE 11,13 

data area layout 210-212 

diagram 80,81 

RQE table 162,165 

scheduling I/O 1 5 

used by stage 2 exit effector routine 102,103 
RQE table, described in module directory 162-165 
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selective retry 258 

selector channel, availability 22 

sense bit settings 

for device failure 108,109 

inUCB 233,234 
sense subroutine 

flowcharts of 140,141 

with CCH at SYSGEN 110,111 
SER 

SER/CCH interface^ in module directory 165 
SERR interface routine 110,111 
shared DASD option 

flowcharts of 127-128,133,139-140,142 

for sense check 22 

for start I/O 18,19 

with PURGE 250,251 
shoulder tap interface routines 272,273 
SMF (system management facility) option 122,133 
stage 2 exit effector routine 102-105 
stage 3 exit effector routine 18-19,104-105 
start I/O appendage 1 1 9, 1 20 
start I/O 

CAW 183 

channel restart routine 165 

condition codes 94,95 

for direct-access devices 

described in module directory 166 

explained 18,19 

interaction with I/O supervisor (diagram) 8 

multiprocessing 272,273 

normal start (diagram) 86,87 

post start I/O routine 166 

register usage 

diagram 100,101 
with tape 90,91 

restart (diagram) 86,87 

RESTORE macro 250,251 

restore routine 251 

scheduled I/O 100,101 

start I/O subroutine, in module directory 166 

SIO instruction 92,93 

text I/O instruction 1 87, 1 88 

for tape devices 

described in module directory 166 
diagram 88,89 
explanation 18,19 

for unit record devices 

described in module directory 166 
explanation 18,19 

volume verification routine, in module directory 
start-I/O subroutine 

interaction with I/O supervisor 

(diagram) 118 
stand-alone CCW 

for direct access 18,19 

for unit record devices 17-19 
statistics record 

defined in glossary 284 

updating statistics table (diagram) 108,109 
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statistics table entry 108,109 
statistics update routine 77 
status indicators (diagram) 98,99 

checking of 21 

diagram 96,97 

for error routines 23,24 
SVC FLIH (first-level interruption handler) 
SVC interruption 4-7 
SVC (supervisor call) 

defined in glossary 284 

routines, by SVC number 



4-7 



svco 


7 


SVC 15 


7,28,36,43 


SVC 16 


13,250,251 


SVC 17 


253 


SVC24 


253 


SVC33 


253-255 


SVC76 


255 


SVC91 


255 


SVC109 


257 


SYSGEN 




(see system generation) 



system completion codes i*t4,^4j 
system generation 

CCH interface (diagram) 110 

channel availability (diagram) 84,85 

channel search routines 22 

creating queues (diagram) 80,81 

determining queue order (diagram) 82,83 

IPL, defined in glossary 282 

NIP, defined in glossary 283 

start I/O (diagram) 92,93 
SYSl.LOGREC 

data area layout 212-222 

defined in glossary 284 

header record 212,213 

inboard record 219-222 

I/O device failure 76 

miscellaneous data record 218,219 

outboard record 75,77,215-217 

(see also error data) 




task control block 169,222-224 

task termination routine 257 

TCB (task control block) 
in data area directory 169 
data area layout 222-224 
defined in glossary 284 

TCH (test channel) instruction 

condition code settings 1 7 , 1 8 , 1 24 
with multiplexor channels 17,18 

test channel common routine 272,273 

test channel routine entry point 17,18 

text channel instruction (TCH) 17,18 

text I/O instruction 18,19 
CSWused 187,188 

trap routines 

for direct-access devices 165 

for tape devices, in module 165 

for unit record and communication devices 



165 
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TSTLNK (12 star link), for RQE 
two-channel switch 

use of alternate path table 182 

for channels 8,9 



13-15 




UCB (unit control block) 

algorithm 226 

in data area directory 169 

data area layout 226-240 

used for scheduling I/O 16 
UCB lookup table 

in data area directory 169 

data area layout 224-226 

described in module directory 162-165 

updating statistics table 108,109 
UCB flags 7,16,207-222 
UCB lookup table 

algorithm for entry points 226 

data area layout 224-226 

described in module directory 162-165 

in data area directory 169 

updating statistics table 108,109 

used to determine UCB of task 96,97 
uncorrectable input/output error message 75 
unit check condition 

for statistics update routine 108,109 

used with error recovery procedures 27 

used with shared DASD option 22 



unit- record and communications devices 17, li 

diagram for start I/O 86,87 

in device statistics table 195,196 

in UCB fields 227 

start I/O operations 17,18 

use of DEB 191 
user interaction with I/O supervisor 3,4 




validity check subroutine 122 
validation of data 

diagram 14 

explanation 1 3 
validating input data 13 
vary path 258 

VARY CHANNEL command 258 
VARY CPU command 258 
VARY PATH command 258 
VOLSTAT routine 

JFCB 256,257 
volume statistics table 241 
volume verification, for direct access 266 




WAIT macro instruction 233,234 
write-to-operator routines 75 

environmental records 76,77 

1052 error routine 27-29 
WTO (write-to-operator) macro instruction 



112,113 
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